diff --git a/.github/CODEOWNERS b/.github/CODEOWNERS index 9b2f60a..db9015e 100644 --- a/.github/CODEOWNERS +++ b/.github/CODEOWNERS @@ -15,7 +15,7 @@ /PROJECT_REGISTRY.md @sergstack /docs/standards/PARENT_CHILD_ISSUE_GATE_STANDARD.md @sergstack /docs/standards/EXISTING_SCRIPT_CONTROLLED_REFACTOR_STANDARD.md @sergstack -/ARCHIVE_MAP.md @sergstack +/docs/reference/ARCHIVE_MAP.md @sergstack /UPLOAD_GUIDE.md @sergstack /REPO_PATHS.md @sergstack /docs/standards/AUTONOMOUS_EXECUTION_STANDARD.md @sergstack diff --git a/MANIFEST.json b/MANIFEST.json index ee35710..36a7edd 100644 --- a/MANIFEST.json +++ b/MANIFEST.json @@ -21,7 +21,7 @@ ], "local_files": [ "AGENTS.md", - "ARCHIVE_MAP.md", + "docs/reference/ARCHIVE_MAP.md", "docs/standards/COMMAND_SURFACE.md", "docs/standards/CONTEXT_PACK_STANDARD.md", "docs/standards/EXISTING_SCRIPT_CONTROLLED_REFACTOR_STANDARD.md", diff --git a/README.md b/README.md index 176a09b..d4f26d9 100644 --- a/README.md +++ b/README.md @@ -98,7 +98,7 @@ For the exact gate definitions, read [`MASTER_STATUS.md`](MASTER_STATUS.md). Useful operating references: -- [`CHATGPT_CODEX_OPERATING_GUIDE.md`](CHATGPT_CODEX_OPERATING_GUIDE.md) +- [`docs/guides/CHATGPT_CODEX_OPERATING_GUIDE.md`](docs/guides/CHATGPT_CODEX_OPERATING_GUIDE.md) - [`SYNC_CONTRACT.md`](SYNC_CONTRACT.md) - [`HANDOFF_STYLE_STANDARD.md`](HANDOFF_STYLE_STANDARD.md) - [`docs/standards/AUTONOMOUS_EXECUTION_STANDARD.md`](docs/standards/AUTONOMOUS_EXECUTION_STANDARD.md) diff --git a/docs/REPOSITORY_MAP.md b/docs/REPOSITORY_MAP.md index 57d19a2..9ad7964 100644 --- a/docs/REPOSITORY_MAP.md +++ b/docs/REPOSITORY_MAP.md @@ -20,6 +20,7 @@ the machine-readable capability registry. | Check required gates | [`MASTER_STATUS.md`](../MASTER_STATUS.md) | Canonical validation and operational gates | | Prepare or review a change | [`GOAL_MODE.md`](../GOAL_MODE.md) | Execution and merge policy | | Sync ChatGPT Project settings | [`UPLOAD_GUIDE.md`](../UPLOAD_GUIDE.md) | Upload and sync guidance | +| Choose ChatGPT or Codex APP | [`CHATGPT_CODEX_OPERATING_GUIDE.md`](guides/CHATGPT_CODEX_OPERATING_GUIDE.md) | Daily routing shortcut | ## Working Architecture @@ -74,6 +75,8 @@ debugging a sync problem. | Current status | root and project-local `CURRENT_STATUS.md` | State maturity and next action; do not redefine gates | | Operations | [`docs/operations/`](operations) | Active sync, smoke-QA, and pilot records; not entry-point policy | | Shared standards | [`docs/standards/`](standards) | Reusable cross-repository standards that are not primary root contracts | +| Guides | [`docs/guides/`](guides) | Cross-repository operator guidance and quick-start material | +| Reference maps | [`docs/reference/`](reference) | Active package maps and supporting reference material | | Gate definitions | `MASTER_STATUS.md` | Define validation and operational gates and point to evidence | | Evidence | [`docs/evidence/`](evidence) | Record what was checked; passing evidence is not production approval | | Delivery artifacts | `Knowledge_Bundles/`, Stream Deck exports | Distributable surfaces derived from canonical sources | diff --git a/docs/autonomous_execution/examples/pilot_evidence/analytics_pilot.json b/docs/autonomous_execution/examples/pilot_evidence/analytics_pilot.json index 5508dde..cb4e9f5 100644 --- a/docs/autonomous_execution/examples/pilot_evidence/analytics_pilot.json +++ b/docs/autonomous_execution/examples/pilot_evidence/analytics_pilot.json @@ -197,7 +197,7 @@ "validation_type": "docs_consistency", "command_or_method": "python3 scripts/check_manifest_paths.py && python3 scripts/check_index_coverage.py && python3 scripts/check_knowledge_bundles.py && python3 scripts/check_repo_public_safety.py && python3 scripts/check_codex_goal_mode_defaults.py && python3 scripts/check_project_instructions_length.py", "validated_revision": "working-tree iter-002 (post-fix)", - "covered_paths": ["MANIFEST.json", "ChatGPT/", "ARCHIVE_MAP.md"], + "covered_paths": ["MANIFEST.json", "ChatGPT/", "docs/reference/ARCHIVE_MAP.md"], "covered_requirement_ids": [], "started_at": "2026-08-06T14:19:00Z", "completed_at": "2026-08-06T14:19:05Z", diff --git a/CHATGPT_CODEX_OPERATING_GUIDE.md b/docs/guides/CHATGPT_CODEX_OPERATING_GUIDE.md similarity index 100% rename from CHATGPT_CODEX_OPERATING_GUIDE.md rename to docs/guides/CHATGPT_CODEX_OPERATING_GUIDE.md diff --git a/ARCHIVE_MAP.md b/docs/reference/ARCHIVE_MAP.md similarity index 95% rename from ARCHIVE_MAP.md rename to docs/reference/ARCHIVE_MAP.md index 48e1aec..bd868a3 100644 --- a/ARCHIVE_MAP.md +++ b/docs/reference/ARCHIVE_MAP.md @@ -2,7 +2,9 @@ ```text AI_OS_Project_Settings_v05/ -├── ARCHIVE_MAP.md +├── docs/ +│ └── reference/ +│ └── ARCHIVE_MAP.md ├── MANIFEST.json ├── MANIFEST.md ├── UPLOAD_GUIDE.md diff --git a/scripts/check_manifest_paths.py b/scripts/check_manifest_paths.py index d1aca2c..3d24d2d 100644 --- a/scripts/check_manifest_paths.py +++ b/scripts/check_manifest_paths.py @@ -36,7 +36,7 @@ "REPO_PATHS.md", "MANIFEST.md", "MANIFEST.json", - "ARCHIVE_MAP.md", + "docs/reference/ARCHIVE_MAP.md", "UPLOAD_GUIDE.md", "CURRENT_STATUS.md", ]