{ "schema_version": "1", "generated_at": "2026-08-09", "description": "Fixed maintenance locations and evidence gates for the Codex learning system.", "areas": [ { "area": "learning-path", "canonical_paths": ["docs/governance/learning-path.yaml", "docs/learning-model.md", "docs/content-matrix.md", "scripts/validate_learning_path.py", "scripts/test_learning_path_lab_uses.py", "scripts/build_learning_path_site.py", "site/learning-path-data.js", "docs/adr/0024-lab-use-progression-contract.md"], "owner": "curriculum-maintainer", "triggers": ["learning-gap", "asset-reassignment", "new-evaluation-fixture", "level-change", "site-path-change"], "required_inputs": ["level-goal", "prerequisites", "primary-assets", "lab-use-relation", "lab-first-seen", "lab-new-capability", "lab-new-artifact", "lab-new-acceptance", "evaluation-ids", "evidence-gate", "graduation-gate", "blocked-condition"], "validation_commands": ["scripts/validate_learning_path.py", "scripts/test_learning_path_lab_uses.py", "scripts/build_learning_path_site.py --check", "scripts/validate_learning_contract.py", "scripts/validate_content_status.py", "scripts/validate_content_completeness.py", "scripts/check_local_links.py"], "status_fields": ["status", "owner", "last_reviewed", "next_review", "evidence"], "next_review": "2026-11-09" }, { "area": "official-facts", "canonical_paths": ["docs/research/openai-codex-baseline.md", "docs/research/openai-codex-facts-refresh-2026-08-09.md", "docs/research/codex-model-selection-official-facts-2026-08-11.md", "docs/governance/fact-impact-registry.yaml", "docs/governance/external-url-audit.yaml", "scripts/audit_external_urls.py", ".github/workflows/external-links.yml"], "owner": "facts-maintainer", "triggers": ["official-doc-change", "product-release", "user-reports-step-failure", "fact-scope-change", "affected-consumer-change"], "required_inputs": ["claim-id", "authoritative-url", "checked-at", "applies-to", "owner", "next-review", "evidence-class", "impact-groups", "affected-chapters", "affected-labs", "affected-skills", "affected-evaluation-tasks", "affected-site-paths", "recheck-level"], "validation_commands": ["scripts/validate_fact_impact_registry.py", "scripts/audit_external_urls.py --check", "scripts/test_external_url_audit.py", "scripts/validate_project.py", "scripts/check_local_links.py"], "status_fields": ["claim_status", "checked_at", "owner", "next_review", "recheck_level", "last_result_run"], "next_review": "2026-09-09" }, { "area": "book-navigation", "canonical_paths": ["docs/governance/book-navigation.yaml", "book/chapters", "book/title-map.json", "book/table-of-contents-EN.md", "scripts/build_book_navigation.py", "scripts/build_book_title_map.py", "scripts/validate_book_navigation.py", "scripts/test_book_navigation_titles.py", "scripts/test_book_title_map.py"], "owner": "curriculum-maintainer", "triggers": ["new-chapter", "chapter-reorder", "chapter-rename", "english-migration", "navigation-report"], "required_inputs": ["stable-chapter-id", "part", "chapter-number", "english-title", "chinese-title", "legacy-source-path", "english-source-path-or-pending-state"], "validation_commands": ["scripts/build_book_navigation.py --check", "scripts/build_book_title_map.py --check", "scripts/validate_book_navigation.py", "scripts/test_book_navigation_titles.py", "scripts/test_book_title_map.py", "scripts/check_local_links.py"], "status_fields": ["status", "owner", "generated_at", "english_path", "legacy_path", "migration_state"], "next_review": "2026-11-09" }, { "area": "chapters", "canonical_paths": ["book/chapters", "book/table-of-contents-EN.md", "docs/content-matrix.md"], "owner": "curriculum-maintainer", "triggers": ["learning-gap", "source-refresh", "user-confusion", "new-domain-example"], "required_inputs": ["problem", "objective", "experiment", "failure-case", "acceptance-checklist", "sources"], "validation_commands": ["scripts/validate_project.py", "scripts/validate_learning_contract.py", "scripts/validate_content_completeness.py", "scripts/check_local_links.py"], "status_fields": ["content_status", "last_reviewed", "owner", "next_review"], "next_review": "2026-11-09" }, { "area": "labs", "canonical_paths": ["book/labs", "book/labs/README-EN.md"], "owner": "lab-maintainer", "triggers": ["chapter-change", "failed-reproduction", "new-boundary-case", "learning-level-change"], "required_inputs": ["low-risk-setup", "observable-output", "evidence", "failure-variant", "secret-boundary", "transfer-task"], "validation_commands": ["scripts/validate_project.py", "scripts/validate_learning_contract.py", "scripts/validate_content_completeness.py", "scripts/check_local_links.py"], "status_fields": ["status", "last_verified", "runtime_evidence", "owner", "next_review"], "next_review": "2026-11-09" }, { "area": "skills", "canonical_paths": ["skills", "docs/skill-registry.md", "docs/quality/skill-quality-standard.md"], "owner": "skills-maintainer", "triggers": ["new-workflow", "trigger-conflict", "dependency-change", "validator-change", "fresh-context-failure"], "required_inputs": ["trigger", "non-trigger", "inputs", "boundaries", "stop-conditions", "output-contract", "source-boundary", "tests"], "validation_commands": ["scripts/validate_project.py", "scripts/validate_skills.py", "H:/Codex/home/skills/.system/skill-creator/scripts/quick_validate.py"], "status_fields": ["skill_status", "validator_result", "fresh_context_status", "owner", "next_review"], "next_review": "2026-11-09" }, { "area": "skill-routing", "canonical_paths": ["docs/governance/skill-routing-contract.yaml", "docs/quality/skill-routing-matrix.md", "skills", "scripts/validate_skill_routing_contract.py", "scripts/test_skill_routing_contract.py"], "owner": "capability-routing-maintainer", "triggers": ["skill-trigger-change", "intent-owner-change", "handoff-change", "precedence-change", "platform-adapter-proposal", "cross-platform-equivalence-claim", "curriculum-layer-change"], "required_inputs": ["declared-intent", "unique-owner", "allowed-handoffs", "precedence", "fixture-expectation", "content-need", "platform-delta", "compatibility-evidence", "evidence-boundary"], "validation_commands": ["scripts/validate_skill_routing_contract.py", "scripts/test_skill_routing_contract.py", "scripts/validate_skills.py", "scripts/build_release_evidence.py --check"], "status_fields": ["status", "owner", "reviewed_at", "next_review", "adapter-status", "claim-disposition"], "next_review": "2026-09-12" }, { "area": "evaluations", "canonical_paths": ["evals/task-set-v1.yaml", "evals/candidates/task-contract-availability-and-channel-v1", "evals/candidates/shift-handoff-v1", "scripts/validate_task_contract_conditions_candidate.py", "scripts/build_shift_handoff_run_packets.py", "scripts/build_shift_handoff_blind_score_packets.py", "scripts/analyze_shift_handoff_pilot.py", "docs/quality/evaluation-framework.md", "docs/quality/shift-handoff-blind-score-packet-v1.md", "docs/adr/0039-bind-evaluation-prompt-hashes-to-serialized-input-bytes.md", "evals/results"], "owner": "evaluation-maintainer", "triggers": ["skill-change", "model-change", "workflow-change", "new-failure-class", "evaluation-candidate-change", "communication-condition-change"], "required_inputs": ["fixed-task", "context", "allowed-actions", "expected-evidence", "forbidden-behavior", "run-log"], "validation_commands": ["scripts/validate_eval_tasks.py", "scripts/validate_task_contract_conditions_candidate.py", "scripts/build_shift_handoff_run_packets.py --check", "scripts/test_build_shift_handoff_run_packets.py", "scripts/build_shift_handoff_blind_score_packets.py --check", "scripts/test_build_shift_handoff_blind_score_packets.py", "scripts/analyze_shift_handoff_pilot.py --check", "scripts/test_analyze_shift_handoff_pilot.py", "scripts/validate_project.py"], "status_fields": ["fixture_status", "run_status", "review_status", "owner", "next_review"], "next_review": "2026-09-09" }, { "area": "sources-and-licenses", "canonical_paths": ["docs/sources/asset-register.md", "docs/sources/archive-audit-2026-08-09.json"], "owner": "source-maintainer", "triggers": ["new-archive", "upstream-license-change", "adaptation-request", "dependency-change"], "required_inputs": ["source", "license", "attribution", "scope", "hash", "distribution-decision"], "validation_commands": ["scripts/audit_input_archives.py", "scripts/validate_project.py"], "status_fields": ["license_status", "distribution_status", "hash", "owner", "next_review"], "next_review": "2026-11-09" }, { "area": "public-site", "canonical_paths": ["site/index.html", "site/reader.html", "site/app.js", "site/styles.css", "site/content-catalog.json", "scripts/build_learning_path_site.py", "scripts/build_site_search_index.py", "scripts/validate_site_accessibility.py", "scripts/test_site_accessibility.py", "scripts/browser_smoke.mjs", "scripts/build_pages_artifact.py", "scripts/test_build_pages_artifact.py", "scripts/serve_pages_candidate.py", "scripts/test_serve_pages_candidate.py", "site/learning-path-data.js", "site/locale-manifest.js", "site/search-index.js", "site/README.md", "package.json", "package-lock.json", "assets/teaching", "assets/cases", "examples/skill-sandbox", "docs/adr/0023-static-accessibility-and-artifact-integrity.md", "docs/adr/0030-lazy-search-and-browser-smoke.md"], "owner": "site-maintainer", "triggers": ["count-change", "content-status-change", "language-coverage-change", "navigation-change", "search-source-change", "browser-report"], "required_inputs": ["current-counts", "real-links", "en-default", "zh-toggle", "status-boundary", "responsive-check", "generated-learning-path-data", "generated-locale-manifest", "generated-search-index", "lazy-load-boundary", "reader-timeout-and-retry", "nonblocking-evidence-note", "mobile-article-first", "browser-smoke-evidence"], "validation_commands": ["scripts/build_learning_path_site.py --check", "scripts/build_site_locale_manifest.py --check", "scripts/build_site_search_index.py --check", "scripts/check_local_links.py", "scripts/validate_site_i18n.py", "scripts/validate_site_accessibility.py", "scripts/test_site_accessibility.py", "scripts/build_pages_artifact.py --check", "scripts/test_build_pages_artifact.py", "scripts/test_serve_pages_candidate.py", "node scripts/browser_smoke.mjs"], "status_fields": ["site_status", "language_coverage", "browser_review", "owner", "next_review"], "next_review": "2026-09-09" }, { "area": "content-status", "canonical_paths": ["docs/governance/content-status.yaml", "docs/governance/executable-examples.yaml", "scripts/validate_content_status.py", "scripts/test_content_status_run_projections.py", "docs/adr/0027-separate-reference-learner-and-transfer-run-status.md"], "owner": "release-maintainer", "triggers": ["count-change", "artifact-status-change", "run-log-added", "review-date-change"], "required_inputs": ["current-counts", "artifact-status", "reference-run-evidence", "learner-run-evidence", "transfer-run-evidence", "review-status", "evidence-paths"], "validation_commands": ["scripts/validate_content_status.py", "scripts/test_content_status_run_projections.py", "scripts/validate_executable_examples.py", "scripts/validate_project.py"], "status_fields": ["status", "reference_run_status", "learner_run_status", "transfer_run_status", "run_status-legacy-learner-alias", "review_status", "owner", "last_reviewed", "next_review"], "next_review": "2026-11-09" }, { "area": "contribution-flow", "canonical_paths": ["CONTRIBUTING.md", "docs/governance/contribution-model.md", "docs/governance/fast-material-review.md", "docs/quality/public-beta-feedback-contract-v1.md", "docs/quality/community-evidence-contribution-protocol-v1.md", "docs/strategy/license-and-contribution-options-2026-08-15.md", "docs/sources/licensing.md", ".github/PULL_REQUEST_TEMPLATE.md", ".github/CODEOWNERS", ".github/ISSUE_TEMPLATE", ".github/workflows/contribution-material.yml", ".github/workflows/quality.yml", "evals/contributions", "scripts/create_contribution_receipt.py", "scripts/test_create_contribution_receipt.py", "scripts/validate_github_templates.py", "scripts/test_validate_github_templates.py", "scripts/validate_contributed_test_material.py", "scripts/test_validate_contributed_test_material.py"], "owner": "governance-maintainer", "triggers": ["contribution-class-change", "review-requirement-change", "issue-intake-change", "pull-request-disclosure-change", "license-or-safety-boundary-change"], "required_inputs": ["accepted-change-types", "canonical-source-routing", "required-evidence", "source-and-license-boundary", "safety-and-external-effects", "status-claim-boundary", "contribution-route", "privacy-boundary", "merge-review-boundary"], "validation_commands": ["scripts/validate_github_templates.py", "scripts/test_validate_github_templates.py", "scripts/validate_contributed_test_material.py", "scripts/test_validate_contributed_test_material.py", "scripts/test_create_contribution_receipt.py", "scripts/validate_repository_security.py", "scripts/test_validate_repository_security.py", "scripts/validate_project.py", "scripts/validate_project_structure.py", "scripts/check_local_links.py"], "status_fields": ["owner", "accepted-change-types", "issue-before-work-cases", "required-disclosures", "next_review"], "next_review": "2026-09-12" }, { "area": "repository-security", "canonical_paths": ["SECURITY.md", "docs/governance/repository-security-policy.yaml", ".github/workflows/security-policy.yml", ".github/PULL_REQUEST_TEMPLATE.md", "site/index.html", "site/reader.html", "scripts/validate_repository_security.py", "scripts/test_validate_repository_security.py", "docs/adr/0036-repository-security-policy-and-pr-gate.md"], "owner": "governance-maintainer", "triggers": ["security-policy-change", "workflow-permission-change", "workflow-trigger-change", "action-pin-change", "dependency-or-supply-chain-change", "ruleset-availability-change", "security-reporting-path-change"], "required_inputs": ["scope", "least-privileged-permissions", "event-boundary", "secret-boundary", "action-pin-source", "manual-review-path", "rollback-path", "evidence-limit", "first-party-source-record", "host-ruleset-status"], "validation_commands": ["scripts/validate_repository_security.py", "scripts/test_validate_repository_security.py", "scripts/validate_github_templates.py", "scripts/validate_project.py", "scripts/build_release_evidence.py --check"], "status_fields": ["status", "owner", "reviewed_at", "next_review", "host_ruleset.status", "evidence_limit"], "next_review": "2026-09-14" }, { "area": "gold-content-admission", "canonical_paths": ["docs/governance/gold-content-admission.yaml", "scripts/validate_gold_content_admission.py", "scripts/test_gold_content_admission.py", "scripts/fixtures/gold-content-admission", "docs/quality/curriculum-portability-and-gold-content-audit-2026-08-12.md"], "owner": "curriculum-maintainer", "triggers": ["new-learning-unit", "new-platform-adapter", "new-field-case", "content-duplication-report", "admission-score-change", "hard-gate-change"], "required_inputs": ["reader-problem", "capability-increment", "consequential-decision", "observable-artifact", "acceptance", "failure-case", "evidence-limit", "transfer", "existing-unit-disposition", "source-license-boundary", "hard-gate-results", "admission-scores"], "validation_commands": ["scripts/validate_gold_content_admission.py", "scripts/test_gold_content_admission.py", "scripts/build_release_evidence.py --check", "scripts/validate_project.py", "scripts/check_local_links.py"], "status_fields": ["status", "hard_gates", "scores", "owner", "reviewed_at", "next_review"], "next_review": "2026-09-12" }, { "area": "curriculum-architecture", "canonical_paths": ["docs/adr/0025-universal-core-codex-flagship-and-platform-adapters.md", "docs/strategy/universal-llm-practice-curriculum-architecture-2026-08-12.md", "docs/charter.md", "docs/book-architecture.md", "docs/learning-model.md", "docs/governance/learning-path.yaml", "docs/governance/book-navigation.yaml", "docs/governance/core-unit-map.yaml", "docs/governance/content-status.yaml", "docs/governance/locale-matrix.yaml", "docs/governance/skill-routing-contract.yaml", "book/routes/universal-core-foundations-EN.md", "book/communication-clinic-EN.md", "book/guides/learning-practice-contract-EN.md", "book/labs/lab-018-language-transfer-EN.md", "skills/prysai-learning-coach/SKILL.md", "scripts/validate_core_unit_map.py", "scripts/test_core_unit_map.py", "scripts/validate_learning_path.py", "scripts/validate_content_status.py", "scripts/validate_skill_routing_contract.py"], "owner": "curriculum-maintainer", "triggers": ["universal-core-change", "platform-adapter-proposal", "cross-platform-claim", "audience-route-change", "application-guide-change", "learning-lab-change", "delayed-retention-claim", "transfer-claim", "project-rename-proposal", "content-identity-migration"], "required_inputs": ["reader-problem", "capability-delta", "canonical-owner", "core-unit-ids", "platform-delta", "fixture-revision", "allowed-aids", "scorer", "answer-leakage-policy", "transfer-delta", "retention-window", "evidence-status", "volatile-fact-sources", "compatibility-map", "rollback-boundary", "owner-decision"], "validation_commands": ["scripts/validate_project.py", "scripts/validate_project_structure.py", "scripts/validate_content_completeness.py", "scripts/validate_learning_contract.py --canonical-en", "scripts/validate_core_unit_map.py", "scripts/test_core_unit_map.py", "scripts/validate_learning_path.py", "scripts/test_learning_path_lab_uses.py", "scripts/validate_content_status.py", "scripts/test_content_status_run_projections.py", "scripts/validate_skill_routing_contract.py", "scripts/test_skill_routing_contract.py", "scripts/check_local_links.py", "scripts/audit_input_archives.py"], "status_fields": ["status", "owner", "scope", "implementation_state", "adapter_status", "brand_decision", "next_review"], "next_review": "2026-09-12" }, { "area": "executable-examples", "canonical_paths": ["docs/governance/executable-examples.yaml", "examples/lab-008-v1", "examples/lab-013-v1", "scripts/validate_executable_examples.py", "scripts/test_executable_examples.py", "scripts/run_lab_008_reference.py", "scripts/validate_lab_008_brief.py", "scripts/test_lab_008_reference.py", "scripts/run_lab_013_reference.py", "scripts/validate_lab_013_reference.py", "scripts/test_lab_013_reference.py", "docs/research/executable-documentation-and-example-verification-2026-08-12.md"], "owner": "documentation-engineering-maintainer", "triggers": ["new-executable-example", "verification-class-change", "example-source-change", "negative-fixture-change", "runtime-evidence-change"], "required_inputs": ["source-path", "verification-class", "environment", "permissions", "network-boundary", "expected-evidence", "negative-fixtures", "blind-spots", "owner"], "validation_commands": ["scripts/validate_executable_examples.py", "scripts/test_executable_examples.py", "scripts/test_lab_008_reference.py", "scripts/test_lab_013_reference.py", "scripts/build_release_evidence.py --check", "scripts/check_local_links.py"], "status_fields": ["status", "verification_classes", "run_status", "learner_run_status", "transfer_status", "owner", "reviewed_at", "next_review"], "next_review": "2026-09-12" }, { "area": "starter-task-contract", "canonical_paths": ["docs/governance/starter-task-contract.yaml", "README.md", "README-EN.md", "site/index.html", "site/app.js", "site/styles.css", "scripts/validate_starter_task_contract.py", "scripts/test_starter_task_contract.py", "scripts/test_site_accessibility.py"], "owner": "curriculum-maintainer", "triggers": ["beginner-entry-change", "starter-prompt-change", "human-check-change", "rescue-prompt-change", "evidence-boundary-change", "progression-route-change"], "required_inputs": ["fixed-fictional-input", "fully-filled-prompt", "expected-characteristics", "three-human-checks", "bounded-rescue", "plain-language-receipt", "evidence-boundary", "advanced-progression"], "validation_commands": ["scripts/validate_starter_task_contract.py", "scripts/test_starter_task_contract.py", "scripts/check_local_links.py", "scripts/validate_site_accessibility.py", "scripts/build_pages_artifact.py --check"], "status_fields": ["status", "owner", "risk_scope", "reviewed_at", "next_review", "evidence_boundary"], "next_review": "2026-09-13" }, { "area": "quality-and-learner-evidence", "canonical_paths": ["docs/governance/quality-register.yaml", "docs/quality/quality-register.md", "docs/quality/first-win-pilot-protocol-v2.md", "docs/governance/first-win-pilot-kit.yaml", "scripts/first_win_pilot_kit.py", "scripts/test_first_win_pilot_kit.py", "scripts/build_quality_register.py", "scripts/test_release_evidence.py"], "owner": "quality-maintainer", "triggers": ["quality-finding-change", "learner-pilot-change", "evaluation-evidence-change", "release-blocker-change"], "required_inputs": ["finding", "severity", "owner", "required-evidence", "current-evidence", "status", "resolution-boundary", "next-review"], "validation_commands": ["scripts/first_win_pilot_kit.py --check", "scripts/test_first_win_pilot_kit.py", "scripts/build_quality_register.py --check", "scripts/test_release_evidence.py", "scripts/validate_update_registry.py", "scripts/check_local_links.py"], "status_fields": ["severity", "status", "owner", "opened_at", "next_review", "resolution_scope"], "next_review": "2026-09-13" }, { "area": "page-trust-registry", "canonical_paths": ["docs/governance/page-trust-registry.yaml", "docs/governance/core-unit-map.yaml", "scripts/validate_page_trust_registry.py", "scripts/test_page_trust_registry.py", "docs/research/live-documentation-trust-and-provenance-benchmark-2026-08-12.md", "docs/sources/asset-register.md"], "owner": "documentation-engineering-maintainer", "triggers": ["page-identity-change", "curriculum-scope-change", "platform-applicability-change", "fact-risk-change", "source-provenance-change", "review-window-change", "license-boundary-change", "coverage-promotion"], "required_inputs": ["content-id", "artifact-status", "curriculum-scope", "platforms", "core-concepts", "applicability", "fact-risk", "owner", "review-window", "typed-sources", "evidence-role", "access-date-for-external-sources", "license-boundary", "reuse-boundary", "limitations"], "validation_commands": ["scripts/validate_page_trust_registry.py", "scripts/test_page_trust_registry.py", "scripts/validate_update_registry.py", "scripts/check_local_links.py"], "status_fields": ["status", "coverage", "curriculum_scope", "platforms", "fact_risk", "owner", "last_reviewed", "next_review", "limitations"], "next_review": "2026-09-12" }, { "area": "release-and-rollback", "canonical_paths": ["docs/release-checklist.md", "docs/governance/content-lifecycle.md", "docs/governance/release-evidence.yaml", "docs/governance/release-readiness.yaml", ".github/workflows/quality.yml", ".github/workflows/release-gate.yml", "scripts/build_release_evidence.py", "scripts/validate_release_readiness.py", "scripts/test_release_readiness.py", "docs/adr/0021-commit-bound-release-evidence.md", "docs/adr/0026-machine-readable-release-readiness.md", "docs/adr/0040-clean-checkout-release-evidence.md", "docs/adr/0042-separate-candidate-quality-from-release-gate.md"], "owner": "release-maintainer", "triggers": ["release-candidate", "public-site-change", "high-risk-content-change", "quality-policy-change", "evidence-dimension-change", "rollback-needed"], "required_inputs": ["candidate-sha", "diff", "gate-logs", "reviewer", "known-gaps", "source-freshness", "version-decision", "changelog", "reviewed-tag", "reviewed-release-evidence", "rollback-target", "rollback-rehearsal", "user-approval"], "validation_commands": ["scripts/build_release_evidence.py --check", "scripts/validate_release_readiness.py", "scripts/test_release_readiness.py", "scripts/validate_project.py", "scripts/check_local_links.py", "scripts/validate_eval_tasks.py"], "status_fields": ["decision", "release_version", "release_status", "review_status", "candidate_sha", "release_tag", "changelog", "rollback_target", "rehearsal_record", "owner", "next_review"], "next_review": "2026-09-09" } ] }