diff --git a/.github/CODEOWNERS b/.github/CODEOWNERS index ad3b019..b5f8cfc 100644 --- a/.github/CODEOWNERS +++ b/.github/CODEOWNERS @@ -3,9 +3,9 @@ /AGENTS.md @sergstack /CLAUDE.md @sergstack /GOAL_MODE.md @sergstack -/GOAL_PACKS.md @sergstack -/COMMAND_SURFACE.md @sergstack -/CONTEXT_PACK_STANDARD.md @sergstack +/docs/standards/GOAL_PACKS.md @sergstack +/docs/standards/COMMAND_SURFACE.md @sergstack +/docs/standards/CONTEXT_PACK_STANDARD.md @sergstack /MASTER_STATUS.md @sergstack /CURRENT_STATUS.md @sergstack /SYNC_CONTRACT.md @sergstack @@ -13,8 +13,8 @@ /MANIFEST.md @sergstack /MANIFEST.json @sergstack /PROJECT_REGISTRY.md @sergstack -/PARENT_CHILD_ISSUE_GATE_STANDARD.md @sergstack -/EXISTING_SCRIPT_CONTROLLED_REFACTOR_STANDARD.md @sergstack +/docs/standards/PARENT_CHILD_ISSUE_GATE_STANDARD.md @sergstack +/docs/standards/EXISTING_SCRIPT_CONTROLLED_REFACTOR_STANDARD.md @sergstack /ARCHIVE_MAP.md @sergstack /UPLOAD_GUIDE.md @sergstack /REPO_PATHS.md @sergstack @@ -22,7 +22,7 @@ /AUTONOMOUS_EXECUTION_EXTENSION_CONTRACT.md @sergstack /ROUTING_RULES.md @sergstack /HANDOFF_STYLE_STANDARD.md @sergstack -/PROMPT_QA_FACTORY.md @sergstack +/docs/standards/PROMPT_QA_FACTORY.md @sergstack /PROJECT_CAPABILITIES.yaml @sergstack /knowledge_bundle_manifest.json @sergstack /docs/operations/CHATGPT_PROJECT_SYNC_CHECKLIST.md @sergstack diff --git a/ChatGPT/[AI OS]/Knowledge/AIOS_01_ROUTING_AND_WORKFLOW_BUNDLE_SEMANTICS.md b/ChatGPT/[AI OS]/Knowledge/AIOS_01_ROUTING_AND_WORKFLOW_BUNDLE_SEMANTICS.md index b0b718e..58966f3 100644 --- a/ChatGPT/[AI OS]/Knowledge/AIOS_01_ROUTING_AND_WORKFLOW_BUNDLE_SEMANTICS.md +++ b/ChatGPT/[AI OS]/Knowledge/AIOS_01_ROUTING_AND_WORKFLOW_BUNDLE_SEMANTICS.md @@ -9,7 +9,7 @@ Legacy bundle provenance: `ChatGPT/[AI OS]/Knowledge_Bundles/AIOS_01_ROUTING_AND If raw-input triage and AI OS scoped routing differ, use Inbox Router for triage and this file for AI OS evidence/governance scope. -## Legacy section: `EXISTING_SCRIPT_CONTROLLED_REFACTOR_STANDARD.md` +## Legacy section: `docs/standards/EXISTING_SCRIPT_CONTROLLED_REFACTOR_STANDARD.md` This is an engineering/Codex standard, not Analytics methodology. It does not define business logic, metrics, formulas, or analytical conclusions. Use `Existing Script Controlled Refactor Standard` when an existing script, CLI, notebook-exported script, or pipeline already runs or has known useful output, and Sergey wants cleanup, controlled refactor, modularization, simplification, or removal of obsolete internal code without behavior loss. @@ -20,7 +20,7 @@ Any output contract change requires separate explicit acceptance. Use the smallest meaningful safety checks: existing tests, focused regression tests, golden-output comparison, smoke run/dry-run, schema check, row-count or reconciliation-total check, CLI help/entrypoint check, artifact validation, `git diff --check`, or repo-specific validation scripts. Allowed only after baseline, output contract, and safety checks exist: extract functions, split internal modules, rename internal helpers, isolate CLI/config/IO/transform/validate/report layers, remove truly dead or obsolete code, remove debug-only branches outside accepted behavior, replace duplicated internal logic with an equivalent helper, clarify comments/docstrings, and add focused tests around preserved behavior. Forbidden without separate explicit acceptance: behavior changes, output contract changes, schema/column/file-format/file-location changes, metric/formula/business-rule/financial-control changes, dependency additions, provider/API behavior changes, real provider/API execution, migrations, production/runtime/deploy changes, broad rewrite, deleting tests/QA/validation, source data mutation, runtime artifacts outside accepted fixture policy, autonomous loops, embeddings, semantic search, vector DB, or web UI. -For large or risky refactors, use `Parent / Child Issue Gate Standard` from `PARENT_CHILD_ISSUE_GATE_STANDARD.md`. Do not duplicate the full parent/child standard. +For large or risky refactors, use `Parent / Child Issue Gate Standard` from `docs/standards/PARENT_CHILD_ISSUE_GATE_STANDARD.md`. Do not duplicate the full parent/child standard. Typical child issues: baseline and output contract; safety tests or golden checks; dead-code cleanup; module extraction; final before/after comparison. Do not start downstream cleanup/refactor child issues until baseline and safety-test child issues are accepted or merged. Pass only when baseline behavior is captured, output contract is explicit, safety tests or comparison checks exist and run, cleanup stays in scope, before/after output is compared, output contract is preserved unless separately accepted, forbidden changes are absent, and final report lists changed files, checks, risks, rollback, and acceptance status. Stop when current behavior cannot be run/inspected/baselined, output contract cannot be inferred safely, no meaningful safety test/comparison path exists, required input data is missing and no safe fixture can be used, the task requires secrets/local absolute paths/production systems/real provider/API/source mutation, preserving behavior conflicts with requested cleanup, or the requested change would alter schema, metrics, formulas, business rules, APIs, file formats, column order, or output locations without separate acceptance. diff --git a/ChatGPT/[AI OS]/Knowledge/AIOS_04_GOAL_PACKS_AND_COMMAND_SURFACE_BUNDLE_SEMANTICS.md b/ChatGPT/[AI OS]/Knowledge/AIOS_04_GOAL_PACKS_AND_COMMAND_SURFACE_BUNDLE_SEMANTICS.md index e95e744..441c149 100644 --- a/ChatGPT/[AI OS]/Knowledge/AIOS_04_GOAL_PACKS_AND_COMMAND_SURFACE_BUNDLE_SEMANTICS.md +++ b/ChatGPT/[AI OS]/Knowledge/AIOS_04_GOAL_PACKS_AND_COMMAND_SURFACE_BUNDLE_SEMANTICS.md @@ -3,7 +3,7 @@ Canonical source created during Issue #285 provenance migration. Legacy bundle provenance: `ChatGPT/[AI OS]/Knowledge_Bundles/AIOS_04_GOAL_PACKS_AND_COMMAND_SURFACE.md`. -## Legacy section: `GOAL_PACKS.md` +## Legacy section: `docs/standards/GOAL_PACKS.md` Goal Packs are reusable workflows for broad goals. Sergey starts from intent; AI-OS, LLM, Analytics, or Codex infer safe execution details. ### Active packs @@ -29,13 +29,13 @@ Goal Packs are reusable workflows for broad goals. Sergey starts from intent; AI | `weekly_ai_os_review` | `[AI OS]` -> `[Thinking]` / `[Codex]` | review drift and choose one next useful improvement | do not create status ledgers or operating journals | | `reconciliation_builder` | `[Analytics]` -> `[Codex]` | build or improve reconciliation workflow | keep numeric logic deterministic and source layers explicit | -## Legacy section: `COMMAND_SURFACE.md` +## Legacy section: `docs/standards/COMMAND_SURFACE.md` One-touch command map for AI-OS, Stream Deck buttons, and quick prompts. Each command starts from the result Sergey wants, not from an atomic task form. | `Autoloop Analysis` | `[Analytics]` | question, data, QA criteria, stop conditions | supervised revise/rerun loop or blocker report | `autoloop` | Usage: -## Legacy section: `CONTEXT_PACK_STANDARD.md` +## Legacy section: `docs/standards/CONTEXT_PACK_STANDARD.md` Context Packs are compact inputs for AI-OS, LLM, Analytics, and Codex workflows. They contain the context needed for the next decision or output, not every available file. ### Minimal schema @@ -43,7 +43,7 @@ Context Packs are compact inputs for AI-OS, LLM, Analytics, and Codex workflows. ### Quality gate A Context Pack is ready when the goal is clear, sources are named, facts and assumptions are separated, constraints and forbidden actions are visible, the expected output is specific, and the receiving project can act without asking Sergey to write an atomic task package. -## Legacy section: `PROMPT_QA_FACTORY.md` +## Legacy section: `docs/standards/PROMPT_QA_FACTORY.md` Core loop: Applies to StreamDeck prompts, ChatGPT Project prompts, Codex prompts, Judge/Revisor prompts, and Analytics memo prompts. diff --git a/ChatGPT/[AI OS]/Knowledge/AI_OS_PROJECT_FILES_INDEX.md b/ChatGPT/[AI OS]/Knowledge/AI_OS_PROJECT_FILES_INDEX.md index c88d65f..4b528a0 100644 --- a/ChatGPT/[AI OS]/Knowledge/AI_OS_PROJECT_FILES_INDEX.md +++ b/ChatGPT/[AI OS]/Knowledge/AI_OS_PROJECT_FILES_INDEX.md @@ -38,7 +38,7 @@ | `JUDGE_CALIBRATION.md` | judge rules | Как AI-OS использует LLM-as-a-Judge, не считая judge output объективной истиной | Перед использованием или изменением judge workflows | | `LOOP_ACCEPTANCE_CHECKLIST.md` | loop QA | Checklist для решения, безопасен ли supervised loop к запуску | Перед запуском или acceptance supervised loop | | `SKILLS_HOOKS_MCP_DECISION_MATRIX.md` | tooling governance | Decision matrix для skills, hooks, MCP tools и sub-agents как workflow aids | Когда нужно решить, добавлять или использовать workflow tooling | -| `EXISTING_SCRIPT_CONTROLLED_REFACTOR_STANDARD.md` | engineering / Codex standard | Controlled cleanup/refactor of existing working scripts without behavior loss | Когда рабочий скрипт надо почистить: сначала baseline, output contract, safety tests, затем refactor | +| `docs/standards/EXISTING_SCRIPT_CONTROLLED_REFACTOR_STANDARD.md` | engineering / Codex standard | Controlled cleanup/refactor of existing working scripts without behavior loss | Когда рабочий скрипт надо почистить: сначала baseline, output contract, safety tests, затем refactor | ## Существующие KB-файлы, которые должны остаться основой diff --git a/ChatGPT/[AI OS]/Knowledge_Bundles/AIOS_01_ROUTING_AND_WORKFLOW.md b/ChatGPT/[AI OS]/Knowledge_Bundles/AIOS_01_ROUTING_AND_WORKFLOW.md index 74eacd0..fefd1a5 100644 --- a/ChatGPT/[AI OS]/Knowledge_Bundles/AIOS_01_ROUTING_AND_WORKFLOW.md +++ b/ChatGPT/[AI OS]/Knowledge_Bundles/AIOS_01_ROUTING_AND_WORKFLOW.md @@ -11,7 +11,7 @@ Compact upload artifact for [AI OS] covering routing, workflow, and engineering/ - `ChatGPT/[AI OS]/Knowledge/AI_OS_WORKFLOW.md` - `ChatGPT/[AI OS]/Knowledge/KB_USAGE_RULES.md` - `ChatGPT/[AI OS]/Knowledge/ANALYTICAL_MEMO_FACTORY_CODEX_APP_WORKFLOW.md` -- `EXISTING_SCRIPT_CONTROLLED_REFACTOR_STANDARD.md` +- `docs/standards/EXISTING_SCRIPT_CONTROLLED_REFACTOR_STANDARD.md` - `ChatGPT/[AI OS]/Knowledge/AIOS_01_ROUTING_AND_WORKFLOW_BUNDLE_SEMANTICS.md` ## Upload target @@ -23,7 +23,7 @@ ChatGPT Project Sources / Knowledge for `[AI OS]`. - production_promotion: no, unless explicitly accepted elsewhere - bundle_type: generated compact upload artifact - source_of_truth: declared granular source files -- source_fingerprint: sha256:485f07d1596d2ebff146ea71793e07ceb6ee02ef0b09dd55ef7adb28bfd15330 +- source_fingerprint: sha256:e672f866db5838b3fa92df97e41e32d0ed1b3446d2df3ca8381e395ee061bac2 - generator: scripts/build_knowledge_bundles.py --- @@ -67,7 +67,7 @@ ChatGPT Project Sources / Knowledge for `[AI OS]`. | `JUDGE_CALIBRATION.md` | judge rules | Как AI-OS использует LLM-as-a-Judge, не считая judge output объективной истиной | Перед использованием или изменением judge workflows | | `LOOP_ACCEPTANCE_CHECKLIST.md` | loop QA | Checklist для решения, безопасен ли supervised loop к запуску | Перед запуском или acceptance supervised loop | | `SKILLS_HOOKS_MCP_DECISION_MATRIX.md` | tooling governance | Decision matrix для skills, hooks, MCP tools и sub-agents как workflow aids | Когда нужно решить, добавлять или использовать workflow tooling | -| `EXISTING_SCRIPT_CONTROLLED_REFACTOR_STANDARD.md` | engineering / Codex standard | Controlled cleanup/refactor of existing working scripts without behavior loss | Когда рабочий скрипт надо почистить: сначала baseline, output contract, safety tests, затем refactor | +| `docs/standards/EXISTING_SCRIPT_CONTROLLED_REFACTOR_STANDARD.md` | engineering / Codex standard | Controlled cleanup/refactor of existing working scripts without behavior loss | Когда рабочий скрипт надо почистить: сначала baseline, output contract, safety tests, затем refactor | ## Существующие KB-файлы, которые должны остаться основой Минимальный ожидаемый набор уже загруженной KB: ```text @@ -397,7 +397,7 @@ Do not force the user into a manual loop where `[Analytics]` asks for Python out - production_promotion: no - source_of_truth: this file plus the granular Analytics and Codex workflow files -## From: `EXISTING_SCRIPT_CONTROLLED_REFACTOR_STANDARD.md` +## From: `docs/standards/EXISTING_SCRIPT_CONTROLLED_REFACTOR_STANDARD.md` # Existing Script Controlled Refactor Standard ## Purpose @@ -515,7 +515,7 @@ cli / entrypoint ``` This split is recommended, not mandatory. Use the smallest structure that makes behavior safer and clearer. ## Parent/child decomposition for large risky refactors -For large or risky refactors, use `Parent / Child Issue Gate Standard` from `PARENT_CHILD_ISSUE_GATE_STANDARD.md`. +For large or risky refactors, use `Parent / Child Issue Gate Standard` from `docs/standards/PARENT_CHILD_ISSUE_GATE_STANDARD.md`. Do not duplicate the full parent/child standard here. A large refactor should usually be split into child issues such as: 1. baseline and output contract; @@ -574,7 +574,7 @@ Legacy bundle provenance: `ChatGPT/[AI OS]/Knowledge_Bundles/AIOS_01_ROUTING_AND `ChatGPT/[Inbox Router]/Knowledge/ROUTING_RULES.md`. If raw-input triage and AI OS scoped routing differ, use Inbox Router for triage and this file for AI OS evidence/governance scope. -## Legacy section: `EXISTING_SCRIPT_CONTROLLED_REFACTOR_STANDARD.md` +## Legacy section: `docs/standards/EXISTING_SCRIPT_CONTROLLED_REFACTOR_STANDARD.md` This is an engineering/Codex standard, not Analytics methodology. It does not define business logic, metrics, formulas, or analytical conclusions. Use `Existing Script Controlled Refactor Standard` when an existing script, CLI, notebook-exported script, or pipeline already runs or has known useful output, and Sergey wants cleanup, controlled refactor, modularization, simplification, or removal of obsolete internal code without behavior loss. Do not use this standard for greenfield implementation, broken-script recovery, requested behavior/schema/metric/formula/API/provider/output-contract changes, production deploy, migration, source mutation, Safe Apply, real provider/API execution without approval, or cases where current behavior cannot be baselined. @@ -584,7 +584,7 @@ Any output contract change requires separate explicit acceptance. Use the smallest meaningful safety checks: existing tests, focused regression tests, golden-output comparison, smoke run/dry-run, schema check, row-count or reconciliation-total check, CLI help/entrypoint check, artifact validation, `git diff --check`, or repo-specific validation scripts. Allowed only after baseline, output contract, and safety checks exist: extract functions, split internal modules, rename internal helpers, isolate CLI/config/IO/transform/validate/report layers, remove truly dead or obsolete code, remove debug-only branches outside accepted behavior, replace duplicated internal logic with an equivalent helper, clarify comments/docstrings, and add focused tests around preserved behavior. Forbidden without separate explicit acceptance: behavior changes, output contract changes, schema/column/file-format/file-location changes, metric/formula/business-rule/financial-control changes, dependency additions, provider/API behavior changes, real provider/API execution, migrations, production/runtime/deploy changes, broad rewrite, deleting tests/QA/validation, source data mutation, runtime artifacts outside accepted fixture policy, autonomous loops, embeddings, semantic search, vector DB, or web UI. -For large or risky refactors, use `Parent / Child Issue Gate Standard` from `PARENT_CHILD_ISSUE_GATE_STANDARD.md`. Do not duplicate the full parent/child standard. +For large or risky refactors, use `Parent / Child Issue Gate Standard` from `docs/standards/PARENT_CHILD_ISSUE_GATE_STANDARD.md`. Do not duplicate the full parent/child standard. Typical child issues: baseline and output contract; safety tests or golden checks; dead-code cleanup; module extraction; final before/after comparison. Do not start downstream cleanup/refactor child issues until baseline and safety-test child issues are accepted or merged. Pass only when baseline behavior is captured, output contract is explicit, safety tests or comparison checks exist and run, cleanup stays in scope, before/after output is compared, output contract is preserved unless separately accepted, forbidden changes are absent, and final report lists changed files, checks, risks, rollback, and acceptance status. Stop when current behavior cannot be run/inspected/baselined, output contract cannot be inferred safely, no meaningful safety test/comparison path exists, required input data is missing and no safe fixture can be used, the task requires secrets/local absolute paths/production systems/real provider/API/source mutation, preserving behavior conflicts with requested cleanup, or the requested change would alter schema, metrics, formulas, business rules, APIs, file formats, column order, or output locations without separate acceptance. diff --git a/ChatGPT/[AI OS]/Knowledge_Bundles/AIOS_04_GOAL_PACKS_AND_COMMAND_SURFACE.md b/ChatGPT/[AI OS]/Knowledge_Bundles/AIOS_04_GOAL_PACKS_AND_COMMAND_SURFACE.md index e9bb4da..0a684fe 100644 --- a/ChatGPT/[AI OS]/Knowledge_Bundles/AIOS_04_GOAL_PACKS_AND_COMMAND_SURFACE.md +++ b/ChatGPT/[AI OS]/Knowledge_Bundles/AIOS_04_GOAL_PACKS_AND_COMMAND_SURFACE.md @@ -6,10 +6,10 @@ Compact upload artifact for [AI OS] covering the first Goal Packs layer, one-tou ## Source files -- `GOAL_PACKS.md` -- `COMMAND_SURFACE.md` -- `CONTEXT_PACK_STANDARD.md` -- `PROMPT_QA_FACTORY.md` +- `docs/standards/GOAL_PACKS.md` +- `docs/standards/COMMAND_SURFACE.md` +- `docs/standards/CONTEXT_PACK_STANDARD.md` +- `docs/standards/PROMPT_QA_FACTORY.md` - `ChatGPT/[AI OS]/Knowledge/WEEKLY_AI_OS_REVIEW_TEMPLATE.md` - `ChatGPT/[AI OS]/Knowledge/ARCHIVE_SUPERSEDED_RULE.md` - `ChatGPT/[AI OS]/Knowledge/AIOS_04_GOAL_PACKS_AND_COMMAND_SURFACE_BUNDLE_SEMANTICS.md` @@ -24,14 +24,14 @@ ChatGPT Project Sources / Knowledge for `[AI OS]`. - default_upload_mode: `Knowledge_Bundles` - bundle_type: generated compact upload artifact - source_of_truth: declared granular source files -- source_fingerprint: sha256:58fe7a793dc4f83042e262e61aed739043c26d5c00598927f6cd3361bd898e41 +- source_fingerprint: sha256:f604982af9b80f3622213a1083e8bc26db04e31af7fe43ca753223aaa1ecf471 - generator: scripts/build_knowledge_bundles.py --- # Content -## From: `GOAL_PACKS.md` +## From: `docs/standards/GOAL_PACKS.md` # Goal Packs Goal Packs are reusable workflows for broad goals. They help Sergey start from intent while AI-OS, LLM, Analytics, or Codex infer the safe execution details. @@ -98,7 +98,7 @@ In default Goal Mode, Goal Packs are not atomic task packages. Codex still compi - trigger: "Turn this reusable prompt into an accepted standard" - route: `[AI OS]` -> owner project -> `[LLM]` / `[Thinking]` judge-revisor when needed -> `[Codex]` only for repo docs or PR work - input: candidate prompt, owner project, use case, test cases, judge criteria, acceptance constraints -- context needed: `PROMPT_QA_FACTORY.md`, supervised loop boundary, prompt registry/library, owner project rules +- context needed: `docs/standards/PROMPT_QA_FACTORY.md`, supervised loop boundary, prompt registry/library, owner project rules - output: Prompt QA Record with candidate -> test -> judge -> revise -> selected status, UX score, residual risks, and acceptance status - quality gate: supervised only; human-owned acceptance required; no production automation, sensitive data, autonomous retrieval, vector DB, embeddings, semantic search, or auto-merge - done when: prompt is selected by owner acceptance or remains a candidate with visible risks and next revision need @@ -106,7 +106,7 @@ In default Goal Mode, Goal Packs are not atomic task packages. Codex still compi - trigger: "Build a compact context package or prompt from this goal" - route: `[LLM]` -> owner project by output type - input: goal, source files or facts, constraints, expected output, risk level -- context needed: `CONTEXT_PACK_STANDARD.md`, prompt registry, routing rules, raw-dump guardrails +- context needed: `docs/standards/CONTEXT_PACK_STANDARD.md`, prompt registry, routing rules, raw-dump guardrails - output: Context Pack or CTC prompt with goal, facts, constraints, forbidden inputs, expected output, and quality gate - quality gate: curated context only; no raw dumps, source-card dumps, chunks, logs, runtime artifacts, secrets, vector DB, embeddings, semantic search, web UI, or autonomous retrieval - done when: receiving project can act without asking Sergey to rewrite the context from scratch @@ -168,7 +168,7 @@ In default Goal Mode, Goal Packs are not atomic task packages. Codex still compi - quality gate: numeric logic is deterministic and source layers stay explicit - done when: reconciliation output is reproducible and exceptions are traceable -## From: `COMMAND_SURFACE.md` +## From: `docs/standards/COMMAND_SURFACE.md` # Command Surface This is the one-touch command map for AI-OS, Stream Deck buttons, and quick prompts. Each command starts from a result Sergey wants, not from an atomic task form. @@ -199,7 +199,7 @@ This is the one-touch command map for AI-OS, Stream Deck buttons, and quick prom - Let the resolved owner infer scope, checks, and next action within its boundary. - Use strict task packages only when scope is already known or risk is high. -## From: `CONTEXT_PACK_STANDARD.md` +## From: `docs/standards/CONTEXT_PACK_STANDARD.md` # Context Pack Standard Context Packs are compact inputs for AI-OS, LLM, Analytics, and Codex workflows. They should contain the context needed for the next decision or output, not every available file. @@ -239,7 +239,7 @@ A Context Pack is ready when: - the expected output is specific; - the receiving project can act without asking Sergey to write an atomic task package. -## From: `PROMPT_QA_FACTORY.md` +## From: `docs/standards/PROMPT_QA_FACTORY.md` # Prompt QA Factory Prompt QA Factory is the AI-OS standard for turning reusable prompts into accepted prompt assets. @@ -458,7 +458,7 @@ Rollback note: # Migrated Bundle Semantics Canonical source created during Issue #285 provenance migration. Legacy bundle provenance: `ChatGPT/[AI OS]/Knowledge_Bundles/AIOS_04_GOAL_PACKS_AND_COMMAND_SURFACE.md`. -## Legacy section: `GOAL_PACKS.md` +## Legacy section: `docs/standards/GOAL_PACKS.md` Goal Packs are reusable workflows for broad goals. Sergey starts from intent; AI-OS, LLM, Analytics, or Codex infer safe execution details. ### Active packs | Pack | Trigger | Route | Output | Quality gate | @@ -482,17 +482,17 @@ Goal Packs are reusable workflows for broad goals. Sergey starts from intent; AI | `security_cleanup` | `[Codex]` | repo-only safety cleanup for risky public-repo artifacts or safety wording | not full access/security management | | `weekly_ai_os_review` | `[AI OS]` -> `[Thinking]` / `[Codex]` | review drift and choose one next useful improvement | do not create status ledgers or operating journals | | `reconciliation_builder` | `[Analytics]` -> `[Codex]` | build or improve reconciliation workflow | keep numeric logic deterministic and source layers explicit | -## Legacy section: `COMMAND_SURFACE.md` +## Legacy section: `docs/standards/COMMAND_SURFACE.md` One-touch command map for AI-OS, Stream Deck buttons, and quick prompts. Each command starts from the result Sergey wants, not from an atomic task form. | `Autoloop Analysis` | `[Analytics]` | question, data, QA criteria, stop conditions | supervised revise/rerun loop or blocker report | `autoloop` | Usage: -## Legacy section: `CONTEXT_PACK_STANDARD.md` +## Legacy section: `docs/standards/CONTEXT_PACK_STANDARD.md` Context Packs are compact inputs for AI-OS, LLM, Analytics, and Codex workflows. They contain the context needed for the next decision or output, not every available file. ### Minimal schema ### Guidance ### Quality gate A Context Pack is ready when the goal is clear, sources are named, facts and assumptions are separated, constraints and forbidden actions are visible, the expected output is specific, and the receiving project can act without asking Sergey to write an atomic task package. -## Legacy section: `PROMPT_QA_FACTORY.md` +## Legacy section: `docs/standards/PROMPT_QA_FACTORY.md` Core loop: Applies to StreamDeck prompts, ChatGPT Project prompts, Codex prompts, Judge/Revisor prompts, and Analytics memo prompts. Selection requires recorded test cases, judge criteria, UX score, residual risks, and owner acceptance. diff --git a/ChatGPT/[AI OS]/Knowledge_Bundles/README.md b/ChatGPT/[AI OS]/Knowledge_Bundles/README.md index 6010970..686d1cd 100644 --- a/ChatGPT/[AI OS]/Knowledge_Bundles/README.md +++ b/ChatGPT/[AI OS]/Knowledge_Bundles/README.md @@ -22,7 +22,7 @@ Use this table to decide which bundle to re-upload after a source file changes. | `AIOS_01_ROUTING_AND_WORKFLOW.md` | `AI_OS_PROJECT_FILES_INDEX.md`, `PROJECT_ROUTING.md`, `AI_OS_WORKFLOW.md`, `KB_USAGE_RULES.md`, `ANALYTICAL_MEMO_FACTORY_CODEX_APP_WORKFLOW.md` | | `AIOS_02_GOVERNANCE_AND_EVIDENCE.md` | `GOVERNANCE_RULES.md`, `ANTI_PATTERNS.md` | | `AIOS_03_HANDOFF_AND_SMOKE_QA.md` | `HANDOFF_PROTOCOL.md`, `GITHUB_ISSUE_DRIVEN_HANDOFF.md`, `SMOKE_QA_FOR_AI_OS.md`, repo-root `HANDOFF_STYLE_STANDARD.md` | -| `AIOS_04_GOAL_PACKS_AND_COMMAND_SURFACE.md` | repo-root `GOAL_PACKS.md`, `COMMAND_SURFACE.md`, `CONTEXT_PACK_STANDARD.md`, `PROMPT_QA_FACTORY.md`; Knowledge `WEEKLY_AI_OS_REVIEW_TEMPLATE.md`, `ARCHIVE_SUPERSEDED_RULE.md` | +| `AIOS_04_GOAL_PACKS_AND_COMMAND_SURFACE.md` | repo-root `docs/standards/GOAL_PACKS.md`, `docs/standards/COMMAND_SURFACE.md`, `docs/standards/CONTEXT_PACK_STANDARD.md`, `docs/standards/PROMPT_QA_FACTORY.md`; Knowledge `WEEKLY_AI_OS_REVIEW_TEMPLATE.md`, `ARCHIVE_SUPERSEDED_RULE.md` | | `AIOS_05_SUPERVISED_AGENT_LOOPS.md` | `AGENT_LOOP_PLAYBOOK.md`, `LOOP_ACCEPTANCE_CHECKLIST.md`, `AUTO_RESEARCH_BACKLOG.md`, `SKILLS_HOOKS_MCP_DECISION_MATRIX.md` | | `AIOS_06_CROSS_PROJECT_AI_EVALS.md` | `AI_EVAL_REGISTRY.md`, `JUDGE_CALIBRATION.md`, `GOLDEN_EVAL_CASES.md`, `CROSS_PROJECT_EVAL_PLAYBOOK.md` | diff --git a/ChatGPT/[Analytics]/Knowledge/ANALYTICS_PROJECT_FILES_INDEX.md b/ChatGPT/[Analytics]/Knowledge/ANALYTICS_PROJECT_FILES_INDEX.md index da3edb5..81a3ecd 100644 --- a/ChatGPT/[Analytics]/Knowledge/ANALYTICS_PROJECT_FILES_INDEX.md +++ b/ChatGPT/[Analytics]/Knowledge/ANALYTICS_PROJECT_FILES_INDEX.md @@ -33,7 +33,7 @@ | `SMOKE_QA_FOR_ANALYTICS.md` | Проверка проекта | После загрузки пакета | | `SMOKE_QA_RESULT.md` | Smoke QA result | Когда нужен последний зафиксированный smoke QA результат | | `CHANGELOG.md` | История изменений | После обновлений | -| `../../../PARENT_CHILD_ISSUE_GATE_STANDARD.md` | Parent / child gate standard | Complex/high-risk analytics work needing sequenced issues, dependency gates, PR gates, final QA | +| `../../../docs/standards/PARENT_CHILD_ISSUE_GATE_STANDARD.md` | Parent / child gate standard | Complex/high-risk analytics work needing sequenced issues, dependency gates, PR gates, final QA | ## Priority rules diff --git a/ChatGPT/[Analytics]/Knowledge_Bundles/ANALYTICS_01_CORE_WORKFLOW.md b/ChatGPT/[Analytics]/Knowledge_Bundles/ANALYTICS_01_CORE_WORKFLOW.md index 65ef94a..776bd9c 100644 --- a/ChatGPT/[Analytics]/Knowledge_Bundles/ANALYTICS_01_CORE_WORKFLOW.md +++ b/ChatGPT/[Analytics]/Knowledge_Bundles/ANALYTICS_01_CORE_WORKFLOW.md @@ -21,7 +21,7 @@ ChatGPT Project Sources / Knowledge for `[Analytics]`. - production_promotion: no, unless explicitly accepted elsewhere - bundle_type: generated compact upload artifact - source_of_truth: declared granular source files -- source_fingerprint: sha256:8afc68368a9437c4ea07a9f3d48c03a9bcc76b48b2c6a1d7713418ec537f6468 +- source_fingerprint: sha256:4156af54cb78414a671a5c4d70a157c7e844e3dab1af0b514354801b5b362dce - generator: scripts/build_knowledge_bundles.py --- @@ -62,7 +62,7 @@ ChatGPT Project Sources / Knowledge for `[Analytics]`. | `SMOKE_QA_FOR_ANALYTICS.md` | Проверка проекта | После загрузки пакета | | `SMOKE_QA_RESULT.md` | Smoke QA result | Когда нужен последний зафиксированный smoke QA результат | | `CHANGELOG.md` | История изменений | После обновлений | -| `../../../PARENT_CHILD_ISSUE_GATE_STANDARD.md` | Parent / child gate standard | Complex/high-risk analytics work needing sequenced issues, dependency gates, PR gates, final QA | +| `../../../docs/standards/PARENT_CHILD_ISSUE_GATE_STANDARD.md` | Parent / child gate standard | Complex/high-risk analytics work needing sequenced issues, dependency gates, PR gates, final QA | ## Priority rules 1. Для аналитических задач сначала используй `ANALYTICS_WORKFLOW.md`, `IN_PROJECT_ANALYSIS_MODE.md`, `MAIN_FILES_STANDARD.md`. 2. Для данных и расчётов используй `DATA_CONTRACTS.md`, `MARTS_DESIGN.md`, `ANALYTICAL_TECHNIQUES.md`; для adaptive reasoning control — `ANALYTICAL_REASONING_STANDARD.md`; для material Plan/Fact diagnostics — `VARIANCE_DIAGNOSTIC_CONTRACT.md`. diff --git a/ChatGPT/[Analytics]/README.md b/ChatGPT/[Analytics]/README.md index bbc82ac..220e359 100644 --- a/ChatGPT/[Analytics]/README.md +++ b/ChatGPT/[Analytics]/README.md @@ -21,7 +21,7 @@ The root-level path `/[Analytics]` is not the active source unless it is explici 2. Загрузи все файлы из папки `Knowledge/` в knowledge area проекта `[Analytics]`. 3. Файлы из `Templates/` можно загрузить как knowledge или держать как рабочие шаблоны. 4. Файлы из `Codex_Tasks/` используй для передачи задач в `[Codex]`, когда нужно изменить код/документы/автоматизацию. -5. Для complex/high-risk analytics work со staged child issues используй `../../PARENT_CHILD_ISSUE_GATE_STANDARD.md` by reference; не копируй полный текст в project guidance. +5. Для complex/high-risk analytics work со staged child issues используй `../../docs/standards/PARENT_CHILD_ISSUE_GATE_STANDARD.md` by reference; не копируй полный текст в project guidance. ZIP — только транспортный архив. Не загружай ZIP как единственный knowledge source, если можно загрузить отдельные `.md` файлы. diff --git a/ChatGPT/[Codex]/Knowledge/CODEX_04_IMPLEMENTATION_WORKFLOWS_BUNDLE_SEMANTICS.md b/ChatGPT/[Codex]/Knowledge/CODEX_04_IMPLEMENTATION_WORKFLOWS_BUNDLE_SEMANTICS.md index dc1068c..593cfe1 100644 --- a/ChatGPT/[Codex]/Knowledge/CODEX_04_IMPLEMENTATION_WORKFLOWS_BUNDLE_SEMANTICS.md +++ b/ChatGPT/[Codex]/Knowledge/CODEX_04_IMPLEMENTATION_WORKFLOWS_BUNDLE_SEMANTICS.md @@ -7,10 +7,10 @@ Legacy bundle provenance: `ChatGPT/[Codex]/Knowledge_Bundles/CODEX_04_IMPLEMENTA `[Codex]` is the task package design layer. Codex APP is the executor layer. -## Legacy section: `EXISTING_SCRIPT_CONTROLLED_REFACTOR_STANDARD.md` +## Legacy section: `docs/standards/EXISTING_SCRIPT_CONTROLLED_REFACTOR_STANDARD.md` Engineering / Codex standard for cleaning or refactoring an existing working script or pipeline without losing useful behavior. Use when an existing script, CLI, notebook-exported script, or pipeline already runs or has known useful output and Sergey asks for cleanup, controlled refactor, modularization, simplification, or removal of obsolete internal code. Do not use for greenfield implementation, bug recovery, Analytics methodology, business definition work, output-contract changes without acceptance, production deploys, migrations, source mutation, or real provider/API execution without separate approval. Core rule: -For large or risky refactors, use `Parent / Child Issue Gate Standard` from `PARENT_CHILD_ISSUE_GATE_STANDARD.md` by reference. +For large or risky refactors, use `Parent / Child Issue Gate Standard` from `docs/standards/PARENT_CHILD_ISSUE_GATE_STANDARD.md` by reference. diff --git a/ChatGPT/[Codex]/Knowledge_Bundles/CODEX_04_IMPLEMENTATION_WORKFLOWS.md b/ChatGPT/[Codex]/Knowledge_Bundles/CODEX_04_IMPLEMENTATION_WORKFLOWS.md index 37f4258..90ac7d0 100644 --- a/ChatGPT/[Codex]/Knowledge_Bundles/CODEX_04_IMPLEMENTATION_WORKFLOWS.md +++ b/ChatGPT/[Codex]/Knowledge_Bundles/CODEX_04_IMPLEMENTATION_WORKFLOWS.md @@ -12,7 +12,7 @@ Compact upload artifact for [Codex] covering implementation workflows. - `ChatGPT/[Codex]/Knowledge/ANALYTICAL_MEMO_AUTOMATION_WORKFLOW.md` - `ChatGPT/[Codex]/Knowledge/ANALYTICAL_TECHNIQUES_FOR_CODEX.md` - `ChatGPT/[AI OS]/Knowledge/ANALYTICAL_MEMO_FACTORY_CODEX_APP_WORKFLOW.md` -- `EXISTING_SCRIPT_CONTROLLED_REFACTOR_STANDARD.md` +- `docs/standards/EXISTING_SCRIPT_CONTROLLED_REFACTOR_STANDARD.md` - `ChatGPT/[Codex]/Knowledge/CODEX_04_IMPLEMENTATION_WORKFLOWS_BUNDLE_SEMANTICS.md` ## Upload target @@ -24,7 +24,7 @@ ChatGPT Project Sources / Knowledge for `[Codex]`. - production_promotion: no, unless explicitly accepted elsewhere - bundle_type: generated compact upload artifact - source_of_truth: declared granular source files -- source_fingerprint: sha256:2e590eac52bf5a3106633fb6ba75b776a7132d511cf54a0139ca71790c884ba9 +- source_fingerprint: sha256:ec821c704f14e805cf1a5cb0fc28ef1da4d594e2813063d2c8b67cb0c349715a - generator: scripts/build_knowledge_bundles.py --- @@ -297,7 +297,7 @@ Do not force the user into a manual loop where `[Analytics]` asks for Python out - production_promotion: no - source_of_truth: this file plus the granular Analytics and Codex workflow files -## From: `EXISTING_SCRIPT_CONTROLLED_REFACTOR_STANDARD.md` +## From: `docs/standards/EXISTING_SCRIPT_CONTROLLED_REFACTOR_STANDARD.md` # Existing Script Controlled Refactor Standard ## Purpose @@ -415,7 +415,7 @@ cli / entrypoint ``` This split is recommended, not mandatory. Use the smallest structure that makes behavior safer and clearer. ## Parent/child decomposition for large risky refactors -For large or risky refactors, use `Parent / Child Issue Gate Standard` from `PARENT_CHILD_ISSUE_GATE_STANDARD.md`. +For large or risky refactors, use `Parent / Child Issue Gate Standard` from `docs/standards/PARENT_CHILD_ISSUE_GATE_STANDARD.md`. Do not duplicate the full parent/child standard here. A large refactor should usually be split into child issues such as: 1. baseline and output contract; @@ -472,9 +472,9 @@ Canonical source created during Issue #285 provenance migration. Legacy bundle provenance: `ChatGPT/[Codex]/Knowledge_Bundles/CODEX_04_IMPLEMENTATION_WORKFLOWS.md`. ## Legacy section: `ChatGPT/[AI OS]/Knowledge/ANALYTICAL_MEMO_FACTORY_CODEX_APP_WORKFLOW.md` `[Codex]` is the task package design layer. Codex APP is the executor layer. -## Legacy section: `EXISTING_SCRIPT_CONTROLLED_REFACTOR_STANDARD.md` +## Legacy section: `docs/standards/EXISTING_SCRIPT_CONTROLLED_REFACTOR_STANDARD.md` Engineering / Codex standard for cleaning or refactoring an existing working script or pipeline without losing useful behavior. Use when an existing script, CLI, notebook-exported script, or pipeline already runs or has known useful output and Sergey asks for cleanup, controlled refactor, modularization, simplification, or removal of obsolete internal code. Do not use for greenfield implementation, bug recovery, Analytics methodology, business definition work, output-contract changes without acceptance, production deploys, migrations, source mutation, or real provider/API execution without separate approval. Core rule: -For large or risky refactors, use `Parent / Child Issue Gate Standard` from `PARENT_CHILD_ISSUE_GATE_STANDARD.md` by reference. +For large or risky refactors, use `Parent / Child Issue Gate Standard` from `docs/standards/PARENT_CHILD_ISSUE_GATE_STANDARD.md` by reference. diff --git a/ChatGPT/[Codex]/PROJECT_INSTRUCTIONS.md b/ChatGPT/[Codex]/PROJECT_INSTRUCTIONS.md index e8267bb..449ecac 100644 --- a/ChatGPT/[Codex]/PROJECT_INSTRUCTIONS.md +++ b/ChatGPT/[Codex]/PROJECT_INSTRUCTIONS.md @@ -30,7 +30,7 @@ When Sergey asks to clean, simplify, modularize, or refactor an existing working Перед работой используй Knowledge по типу задачи: - task/handoff/autonomy: `TASK_TEMPLATE.md`, `CODEX_HANDOFF_WORKFLOW.md`, `AUTONOMY_POLICY.md`, `CODEX_LONG_RUN_PLAYBOOK.md`; - agent/testing/reporting: `AGENTS.md`, `TESTING_WORKFLOW.md`, `ACCEPTANCE_CRITERIA.md`, `FAILURE_MODES.md`, `EXECUTION_REPORTING_RULES.md`; `CLAUDE.md` is legacy/reference only; -- implementation workflows: `REFACTORING_WORKFLOW.md`, `CODEX_TDD_WORKFLOW.md`, and `EXISTING_SCRIPT_CONTROLLED_REFACTOR_STANDARD.md` for controlled cleanup/refactor of existing working scripts; +- implementation workflows: `REFACTORING_WORKFLOW.md`, `CODEX_TDD_WORKFLOW.md`, and `docs/standards/EXISTING_SCRIPT_CONTROLLED_REFACTOR_STANDARD.md` for controlled cleanup/refactor of existing working scripts; - domain/GitHub/App: data and memo workflows, `AI_OS_REFERENCE.md`, `LOCAL_GITHUB_SYNC_WORKFLOW.md`, and relevant `../../Codex APP/` contracts/templates. Приоритет: diff --git a/ChatGPT/[Codex]/README.md b/ChatGPT/[Codex]/README.md index b715479..b160617 100644 --- a/ChatGPT/[Codex]/README.md +++ b/ChatGPT/[Codex]/README.md @@ -24,7 +24,7 @@ Do not upload granular `Knowledge/` files together with bundles unless debugging ## Active granular Knowledge sources -- `../../EXISTING_SCRIPT_CONTROLLED_REFACTOR_STANDARD.md` — shared engineering/Codex standard for controlled cleanup/refactor of existing working scripts. +- `../../docs/standards/EXISTING_SCRIPT_CONTROLLED_REFACTOR_STANDARD.md` — shared engineering/Codex standard for controlled cleanup/refactor of existing working scripts. - `ACCEPTANCE_CRITERIA.md` - `AGENTS.md` - `AI_OS_REFERENCE.md` @@ -73,9 +73,9 @@ Do not upload: Task packages produced in this ChatGPT Project should be executable by `Codex APP`. Use `../../Codex APP/CODEX_APP_TASK_PACKAGE_CONTRACT.md` and `../../Codex APP/CODEX_APP_INTAKE_GATE.md` as the receiving-side contract. -For complex/high-risk GitHub issue sequences, cite `../../PARENT_CHILD_ISSUE_GATE_STANDARD.md` as the parent/child dependency gate reference. Do not use it to make child issues mandatory for simple Goal Mode tasks. +For complex/high-risk GitHub issue sequences, cite `../../docs/standards/PARENT_CHILD_ISSUE_GATE_STANDARD.md` as the parent/child dependency gate reference. Do not use it to make child issues mandatory for simple Goal Mode tasks. -For existing working script or pipeline cleanup/refactor, cite `../../EXISTING_SCRIPT_CONTROLLED_REFACTOR_STANDARD.md`; `[Codex]` applies it operationally after current behavior, output contract, and safety tests are pinned down. +For existing working script or pipeline cleanup/refactor, cite `../../docs/standards/EXISTING_SCRIPT_CONTROLLED_REFACTOR_STANDARD.md`; `[Codex]` applies it operationally after current behavior, output contract, and safety tests are pinned down. ## Что не делать diff --git a/ChatGPT/[LLM]/Knowledge/CONTEXT_ENGINEERING_PLAYBOOK.md b/ChatGPT/[LLM]/Knowledge/CONTEXT_ENGINEERING_PLAYBOOK.md index b86b04c..be5076d 100644 --- a/ChatGPT/[LLM]/Knowledge/CONTEXT_ENGINEERING_PLAYBOOK.md +++ b/ChatGPT/[LLM]/Knowledge/CONTEXT_ENGINEERING_PLAYBOOK.md @@ -4,7 +4,7 @@ Define the lightweight context engineering workflow for `[LLM]`. -`CONTEXT_PACK_STANDARD.md` remains the reusable root standard. This playbook explains how `[LLM]` prepares prompt-ready context without turning raw material into a dump. +`docs/standards/CONTEXT_PACK_STANDARD.md` remains the reusable root standard. This playbook explains how `[LLM]` prepares prompt-ready context without turning raw material into a dump. ## Ownership @@ -34,7 +34,7 @@ goal Use a full Context Pack when the receiving project needs reusable context, multi-step work, implementation, evidence-sensitive reasoning, or handoff. -Minimum sections stay aligned with `CONTEXT_PACK_STANDARD.md`: +Minimum sections stay aligned with `docs/standards/CONTEXT_PACK_STANDARD.md`: - Goal - Decision needed diff --git a/ChatGPT/[LLM]/Knowledge_Bundles/LLM_05_CONTEXT_ENGINEERING.md b/ChatGPT/[LLM]/Knowledge_Bundles/LLM_05_CONTEXT_ENGINEERING.md index 9a2a7fd..4f09d55 100644 --- a/ChatGPT/[LLM]/Knowledge_Bundles/LLM_05_CONTEXT_ENGINEERING.md +++ b/ChatGPT/[LLM]/Knowledge_Bundles/LLM_05_CONTEXT_ENGINEERING.md @@ -6,7 +6,7 @@ Compact upload artifact for `[LLM]` covering context engineering, CTC prompts, c ## Source files -- `CONTEXT_PACK_STANDARD.md` +- `docs/standards/CONTEXT_PACK_STANDARD.md` - `ChatGPT/[LLM]/Knowledge/CONTEXT_ENGINEERING_PLAYBOOK.md` - `ChatGPT/[LLM]/Knowledge/CTC_PROMPT_STANDARD.md` - `ChatGPT/[LLM]/Knowledge/CONTEXT_INTAKE_CHECKLIST.md` @@ -22,14 +22,14 @@ ChatGPT Project Sources / Knowledge for `[LLM]`. - autonomous_retrieval: no - bundle_type: generated compact upload artifact - source_of_truth: declared granular source files -- source_fingerprint: sha256:42c83642bdfc5f30dfc907be796457f431e5e29252b9b58d3c70b69fc997e04f +- source_fingerprint: sha256:93f876d6e36a1cf2427f6a1072a7cb35d3e57ac08ba009a6c4287c61d49f4094 - generator: scripts/build_knowledge_bundles.py --- # Content -## From: `CONTEXT_PACK_STANDARD.md` +## From: `docs/standards/CONTEXT_PACK_STANDARD.md` # Context Pack Standard Context Packs are compact inputs for AI-OS, LLM, Analytics, and Codex workflows. They should contain the context needed for the next decision or output, not every available file. @@ -74,7 +74,7 @@ A Context Pack is ready when: # Context Engineering Playbook ## Purpose Define the lightweight context engineering workflow for `[LLM]`. -`CONTEXT_PACK_STANDARD.md` remains the reusable root standard. This playbook explains how `[LLM]` prepares prompt-ready context without turning raw material into a dump. +`docs/standards/CONTEXT_PACK_STANDARD.md` remains the reusable root standard. This playbook explains how `[LLM]` prepares prompt-ready context without turning raw material into a dump. ## Ownership - `[LLM]` owns prompt/context workflows, prompt registry, CTC prompts, and context pack preparation. - `[AI OS]` owns KB evidence, governance, supported / weak / unsupported labels, and AI pattern checks. @@ -97,7 +97,7 @@ goal ``` ## Context Pack Use Use a full Context Pack when the receiving project needs reusable context, multi-step work, implementation, evidence-sensitive reasoning, or handoff. -Minimum sections stay aligned with `CONTEXT_PACK_STANDARD.md`: +Minimum sections stay aligned with `docs/standards/CONTEXT_PACK_STANDARD.md`: - Goal - Decision needed - Relevant files diff --git a/GOAL_MODE.md b/GOAL_MODE.md index 2c17123..2a1d971 100644 --- a/GOAL_MODE.md +++ b/GOAL_MODE.md @@ -78,7 +78,7 @@ Technical checks passed, pipeline completed, files generated, or PR opened are n ## Existing working script refactors -When Sergey asks to clean, simplify, modularize, or refactor an existing working script or pipeline, use `Existing Script Controlled Refactor Standard` from `EXISTING_SCRIPT_CONTROLLED_REFACTOR_STANDARD.md`. +When Sergey asks to clean, simplify, modularize, or refactor an existing working script or pipeline, use `Existing Script Controlled Refactor Standard` from `docs/standards/EXISTING_SCRIPT_CONTROLLED_REFACTOR_STANDARD.md`. This standard is not mandatory for all tasks. It applies only when current behavior is useful and must be preserved. @@ -100,7 +100,7 @@ Router, AI OS, LLM, or Codex may turn that goal into a route, scope, execution p Do not produce a roadmap, epic, child-issue tree, or approval package for a clear implementation goal unless Sergey explicitly asks for planning or a hard blocker prevents bounded execution. -If the work is complex or high-risk enough to require sequenced child issues and PR gates, reference `Parent / Child Issue Gate Standard` from `PARENT_CHILD_ISSUE_GATE_STANDARD.md` instead of duplicating the standard. This is an advanced gate pattern, not a requirement for simple Goal Mode tasks. +If the work is complex or high-risk enough to require sequenced child issues and PR gates, reference `Parent / Child Issue Gate Standard` from `docs/standards/PARENT_CHILD_ISSUE_GATE_STANDARD.md` instead of duplicating the standard. This is an advanced gate pattern, not a requirement for simple Goal Mode tasks. ## Autonomy diff --git a/MANIFEST.json b/MANIFEST.json index 582eab1..ee35710 100644 --- a/MANIFEST.json +++ b/MANIFEST.json @@ -22,12 +22,12 @@ "local_files": [ "AGENTS.md", "ARCHIVE_MAP.md", - "COMMAND_SURFACE.md", - "CONTEXT_PACK_STANDARD.md", - "EXISTING_SCRIPT_CONTROLLED_REFACTOR_STANDARD.md", - "GOAL_PACKS.md", + "docs/standards/COMMAND_SURFACE.md", + "docs/standards/CONTEXT_PACK_STANDARD.md", + "docs/standards/EXISTING_SCRIPT_CONTROLLED_REFACTOR_STANDARD.md", + "docs/standards/GOAL_PACKS.md", "GOAL_MODE.md", - "PARENT_CHILD_ISSUE_GATE_STANDARD.md", + "docs/standards/PARENT_CHILD_ISSUE_GATE_STANDARD.md", "SYNC_CONTRACT.md", "UPLOAD_GUIDE.md", "ChatGPT/[AI OS]/PROJECT_INSTRUCTIONS.md", diff --git a/MANIFEST.md b/MANIFEST.md index ed4af43..617b7ca 100644 --- a/MANIFEST.md +++ b/MANIFEST.md @@ -27,7 +27,7 @@ Semantics: source inventory for project settings. Default manual ChatGPT Project ## Local / setup files - `ARCHIVE_MAP.md` -- `PARENT_CHILD_ISSUE_GATE_STANDARD.md` +- `docs/standards/PARENT_CHILD_ISSUE_GATE_STANDARD.md` - `UPLOAD_GUIDE.md` - `ChatGPT/[AI OS]/PROJECT_INSTRUCTIONS.md` - `ChatGPT/[AI OS]/README.md` diff --git a/docs/REPOSITORY_MAP.md b/docs/REPOSITORY_MAP.md index 4ea39cb..57d19a2 100644 --- a/docs/REPOSITORY_MAP.md +++ b/docs/REPOSITORY_MAP.md @@ -73,6 +73,7 @@ debugging a sync problem. | Governance and contracts | `AGENTS.md`, `GOAL_MODE.md`, active standards | Normative rules; protected-path review applies | | 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 | | 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/knowledge_bundle_provenance_audit.json b/docs/knowledge_bundle_provenance_audit.json index 3bc8146..8a19763 100644 --- a/docs/knowledge_bundle_provenance_audit.json +++ b/docs/knowledge_bundle_provenance_audit.json @@ -18,11 +18,11 @@ "ChatGPT/[AI OS]/Knowledge/AI_OS_WORKFLOW.md", "ChatGPT/[AI OS]/Knowledge/KB_USAGE_RULES.md", "ChatGPT/[AI OS]/Knowledge/ANALYTICAL_MEMO_FACTORY_CODEX_APP_WORKFLOW.md", - "EXISTING_SCRIPT_CONTROLLED_REFACTOR_STANDARD.md", + "docs/standards/EXISTING_SCRIPT_CONTROLLED_REFACTOR_STANDARD.md", "ChatGPT/[AI OS]/Knowledge/AIOS_01_ROUTING_AND_WORKFLOW_BUNDLE_SEMANTICS.md" ], - "source_bytes": 33035, - "bundle_bytes": 34325, + "source_bytes": 33095, + "bundle_bytes": 34415, "classification": "equivalent", "bundle_only_excerpt_or_ref": [], "source_only_excerpt_or_ref": [], @@ -76,16 +76,16 @@ "project": "[AI OS]", "bundle_path": "ChatGPT/[AI OS]/Knowledge_Bundles/AIOS_04_GOAL_PACKS_AND_COMMAND_SURFACE.md", "source_paths": [ - "GOAL_PACKS.md", - "COMMAND_SURFACE.md", - "CONTEXT_PACK_STANDARD.md", - "PROMPT_QA_FACTORY.md", + "docs/standards/GOAL_PACKS.md", + "docs/standards/COMMAND_SURFACE.md", + "docs/standards/CONTEXT_PACK_STANDARD.md", + "docs/standards/PROMPT_QA_FACTORY.md", "ChatGPT/[AI OS]/Knowledge/WEEKLY_AI_OS_REVIEW_TEMPLATE.md", "ChatGPT/[AI OS]/Knowledge/ARCHIVE_SUPERSEDED_RULE.md", "ChatGPT/[AI OS]/Knowledge/AIOS_04_GOAL_PACKS_AND_COMMAND_SURFACE_BUNDLE_SEMANTICS.md" ], - "source_bytes": 27927, - "bundle_bytes": 29116, + "source_bytes": 28017, + "bundle_bytes": 29326, "classification": "equivalent", "bundle_only_excerpt_or_ref": [], "source_only_excerpt_or_ref": [], @@ -225,8 +225,8 @@ "ChatGPT/[Analytics]/Knowledge/MAIN_FILES_STANDARD.md", "ChatGPT/[Analytics]/Knowledge/ANALYTICS_01_CORE_WORKFLOW_BUNDLE_SEMANTICS.md" ], - "source_bytes": 26492, - "bundle_bytes": 27549, + "source_bytes": 26507, + "bundle_bytes": 27564, "classification": "equivalent", "bundle_only_excerpt_or_ref": [], "source_only_excerpt_or_ref": [], @@ -468,14 +468,14 @@ "project": "[LLM]", "bundle_path": "ChatGPT/[LLM]/Knowledge_Bundles/LLM_05_CONTEXT_ENGINEERING.md", "source_paths": [ - "CONTEXT_PACK_STANDARD.md", + "docs/standards/CONTEXT_PACK_STANDARD.md", "ChatGPT/[LLM]/Knowledge/CONTEXT_ENGINEERING_PLAYBOOK.md", "ChatGPT/[LLM]/Knowledge/CTC_PROMPT_STANDARD.md", "ChatGPT/[LLM]/Knowledge/CONTEXT_INTAKE_CHECKLIST.md", "ChatGPT/[LLM]/Knowledge/GOOD_BAD_CONTEXT_EXAMPLES.md" ], - "source_bytes": 10172, - "bundle_bytes": 11223, + "source_bytes": 10202, + "bundle_bytes": 11283, "classification": "equivalent", "bundle_only_excerpt_or_ref": [], "source_only_excerpt_or_ref": [], @@ -576,11 +576,11 @@ "ChatGPT/[Codex]/Knowledge/ANALYTICAL_MEMO_AUTOMATION_WORKFLOW.md", "ChatGPT/[Codex]/Knowledge/ANALYTICAL_TECHNIQUES_FOR_CODEX.md", "ChatGPT/[AI OS]/Knowledge/ANALYTICAL_MEMO_FACTORY_CODEX_APP_WORKFLOW.md", - "EXISTING_SCRIPT_CONTROLLED_REFACTOR_STANDARD.md", + "docs/standards/EXISTING_SCRIPT_CONTROLLED_REFACTOR_STANDARD.md", "ChatGPT/[Codex]/Knowledge/CODEX_04_IMPLEMENTATION_WORKFLOWS_BUNDLE_SEMANTICS.md" ], - "source_bytes": 16772, - "bundle_bytes": 18281, + "source_bytes": 16817, + "bundle_bytes": 18356, "classification": "equivalent", "bundle_only_excerpt_or_ref": [], "source_only_excerpt_or_ref": [], diff --git a/docs/knowledge_bundle_provenance_audit.md b/docs/knowledge_bundle_provenance_audit.md index 459e82b..f8d2679 100644 --- a/docs/knowledge_bundle_provenance_audit.md +++ b/docs/knowledge_bundle_provenance_audit.md @@ -44,9 +44,9 @@ Blocking record count: **0** ## `ChatGPT/[AI OS]/Knowledge_Bundles/AIOS_01_ROUTING_AND_WORKFLOW.md` - Project: [AI OS] -- Source paths: `ChatGPT/[AI OS]/Knowledge/AI_OS_PROJECT_FILES_INDEX.md`, `ChatGPT/[AI OS]/Knowledge/PROJECT_ROUTING.md`, `ChatGPT/[AI OS]/Knowledge/AI_OS_WORKFLOW.md`, `ChatGPT/[AI OS]/Knowledge/KB_USAGE_RULES.md`, `ChatGPT/[AI OS]/Knowledge/ANALYTICAL_MEMO_FACTORY_CODEX_APP_WORKFLOW.md`, `EXISTING_SCRIPT_CONTROLLED_REFACTOR_STANDARD.md`, `ChatGPT/[AI OS]/Knowledge/AIOS_01_ROUTING_AND_WORKFLOW_BUNDLE_SEMANTICS.md` -- Source bytes: 33035 -- Bundle bytes: 34325 +- Source paths: `ChatGPT/[AI OS]/Knowledge/AI_OS_PROJECT_FILES_INDEX.md`, `ChatGPT/[AI OS]/Knowledge/PROJECT_ROUTING.md`, `ChatGPT/[AI OS]/Knowledge/AI_OS_WORKFLOW.md`, `ChatGPT/[AI OS]/Knowledge/KB_USAGE_RULES.md`, `ChatGPT/[AI OS]/Knowledge/ANALYTICAL_MEMO_FACTORY_CODEX_APP_WORKFLOW.md`, `docs/standards/EXISTING_SCRIPT_CONTROLLED_REFACTOR_STANDARD.md`, `ChatGPT/[AI OS]/Knowledge/AIOS_01_ROUTING_AND_WORKFLOW_BUNDLE_SEMANTICS.md` +- Source bytes: 33095 +- Bundle bytes: 34415 - Classification: equivalent - Mapping status: mapped - Resolution status: not_applicable @@ -86,9 +86,9 @@ Blocking record count: **0** ## `ChatGPT/[AI OS]/Knowledge_Bundles/AIOS_04_GOAL_PACKS_AND_COMMAND_SURFACE.md` - Project: [AI OS] -- Source paths: `GOAL_PACKS.md`, `COMMAND_SURFACE.md`, `CONTEXT_PACK_STANDARD.md`, `PROMPT_QA_FACTORY.md`, `ChatGPT/[AI OS]/Knowledge/WEEKLY_AI_OS_REVIEW_TEMPLATE.md`, `ChatGPT/[AI OS]/Knowledge/ARCHIVE_SUPERSEDED_RULE.md`, `ChatGPT/[AI OS]/Knowledge/AIOS_04_GOAL_PACKS_AND_COMMAND_SURFACE_BUNDLE_SEMANTICS.md` -- Source bytes: 27927 -- Bundle bytes: 29116 +- Source paths: `docs/standards/GOAL_PACKS.md`, `docs/standards/COMMAND_SURFACE.md`, `docs/standards/CONTEXT_PACK_STANDARD.md`, `docs/standards/PROMPT_QA_FACTORY.md`, `ChatGPT/[AI OS]/Knowledge/WEEKLY_AI_OS_REVIEW_TEMPLATE.md`, `ChatGPT/[AI OS]/Knowledge/ARCHIVE_SUPERSEDED_RULE.md`, `ChatGPT/[AI OS]/Knowledge/AIOS_04_GOAL_PACKS_AND_COMMAND_SURFACE_BUNDLE_SEMANTICS.md` +- Source bytes: 28017 +- Bundle bytes: 29326 - Classification: equivalent - Mapping status: mapped - Resolution status: not_applicable @@ -185,8 +185,8 @@ Blocking record count: **0** - Project: [Analytics] - Source paths: `ChatGPT/[Analytics]/Knowledge/ANALYTICS_PROJECT_FILES_INDEX.md`, `ChatGPT/[Analytics]/Knowledge/ANALYTICS_WORKFLOW.md`, `ChatGPT/[Analytics]/Knowledge/IN_PROJECT_ANALYSIS_MODE.md`, `ChatGPT/[Analytics]/Knowledge/MAIN_FILES_STANDARD.md`, `ChatGPT/[Analytics]/Knowledge/ANALYTICS_01_CORE_WORKFLOW_BUNDLE_SEMANTICS.md` -- Source bytes: 26492 -- Bundle bytes: 27549 +- Source bytes: 26507 +- Bundle bytes: 27564 - Classification: equivalent - Mapping status: mapped - Resolution status: not_applicable @@ -338,9 +338,9 @@ Blocking record count: **0** ## `ChatGPT/[LLM]/Knowledge_Bundles/LLM_05_CONTEXT_ENGINEERING.md` - Project: [LLM] -- Source paths: `CONTEXT_PACK_STANDARD.md`, `ChatGPT/[LLM]/Knowledge/CONTEXT_ENGINEERING_PLAYBOOK.md`, `ChatGPT/[LLM]/Knowledge/CTC_PROMPT_STANDARD.md`, `ChatGPT/[LLM]/Knowledge/CONTEXT_INTAKE_CHECKLIST.md`, `ChatGPT/[LLM]/Knowledge/GOOD_BAD_CONTEXT_EXAMPLES.md` -- Source bytes: 10172 -- Bundle bytes: 11223 +- Source paths: `docs/standards/CONTEXT_PACK_STANDARD.md`, `ChatGPT/[LLM]/Knowledge/CONTEXT_ENGINEERING_PLAYBOOK.md`, `ChatGPT/[LLM]/Knowledge/CTC_PROMPT_STANDARD.md`, `ChatGPT/[LLM]/Knowledge/CONTEXT_INTAKE_CHECKLIST.md`, `ChatGPT/[LLM]/Knowledge/GOOD_BAD_CONTEXT_EXAMPLES.md` +- Source bytes: 10202 +- Bundle bytes: 11283 - Classification: equivalent - Mapping status: mapped - Resolution status: not_applicable @@ -408,9 +408,9 @@ Blocking record count: **0** ## `ChatGPT/[Codex]/Knowledge_Bundles/CODEX_04_IMPLEMENTATION_WORKFLOWS.md` - Project: [Codex] -- Source paths: `ChatGPT/[Codex]/Knowledge/BUGFIX_WORKFLOW.md`, `ChatGPT/[Codex]/Knowledge/REFACTORING_WORKFLOW.md`, `ChatGPT/[Codex]/Knowledge/DATA_PIPELINE_IMPLEMENTATION_WORKFLOW.md`, `ChatGPT/[Codex]/Knowledge/ANALYTICAL_MEMO_AUTOMATION_WORKFLOW.md`, `ChatGPT/[Codex]/Knowledge/ANALYTICAL_TECHNIQUES_FOR_CODEX.md`, `ChatGPT/[AI OS]/Knowledge/ANALYTICAL_MEMO_FACTORY_CODEX_APP_WORKFLOW.md`, `EXISTING_SCRIPT_CONTROLLED_REFACTOR_STANDARD.md`, `ChatGPT/[Codex]/Knowledge/CODEX_04_IMPLEMENTATION_WORKFLOWS_BUNDLE_SEMANTICS.md` -- Source bytes: 16772 -- Bundle bytes: 18281 +- Source paths: `ChatGPT/[Codex]/Knowledge/BUGFIX_WORKFLOW.md`, `ChatGPT/[Codex]/Knowledge/REFACTORING_WORKFLOW.md`, `ChatGPT/[Codex]/Knowledge/DATA_PIPELINE_IMPLEMENTATION_WORKFLOW.md`, `ChatGPT/[Codex]/Knowledge/ANALYTICAL_MEMO_AUTOMATION_WORKFLOW.md`, `ChatGPT/[Codex]/Knowledge/ANALYTICAL_TECHNIQUES_FOR_CODEX.md`, `ChatGPT/[AI OS]/Knowledge/ANALYTICAL_MEMO_FACTORY_CODEX_APP_WORKFLOW.md`, `docs/standards/EXISTING_SCRIPT_CONTROLLED_REFACTOR_STANDARD.md`, `ChatGPT/[Codex]/Knowledge/CODEX_04_IMPLEMENTATION_WORKFLOWS_BUNDLE_SEMANTICS.md` +- Source bytes: 16817 +- Bundle bytes: 18356 - Classification: equivalent - Mapping status: mapped - Resolution status: not_applicable diff --git a/COMMAND_SURFACE.md b/docs/standards/COMMAND_SURFACE.md similarity index 100% rename from COMMAND_SURFACE.md rename to docs/standards/COMMAND_SURFACE.md diff --git a/CONTEXT_PACK_STANDARD.md b/docs/standards/CONTEXT_PACK_STANDARD.md similarity index 100% rename from CONTEXT_PACK_STANDARD.md rename to docs/standards/CONTEXT_PACK_STANDARD.md diff --git a/EXISTING_SCRIPT_CONTROLLED_REFACTOR_STANDARD.md b/docs/standards/EXISTING_SCRIPT_CONTROLLED_REFACTOR_STANDARD.md similarity index 99% rename from EXISTING_SCRIPT_CONTROLLED_REFACTOR_STANDARD.md rename to docs/standards/EXISTING_SCRIPT_CONTROLLED_REFACTOR_STANDARD.md index 4729f80..aba66d4 100644 --- a/EXISTING_SCRIPT_CONTROLLED_REFACTOR_STANDARD.md +++ b/docs/standards/EXISTING_SCRIPT_CONTROLLED_REFACTOR_STANDARD.md @@ -156,7 +156,7 @@ This split is recommended, not mandatory. Use the smallest structure that makes ## Parent/child decomposition for large risky refactors -For large or risky refactors, use `Parent / Child Issue Gate Standard` from `PARENT_CHILD_ISSUE_GATE_STANDARD.md`. +For large or risky refactors, use `Parent / Child Issue Gate Standard` from `docs/standards/PARENT_CHILD_ISSUE_GATE_STANDARD.md`. Do not duplicate the full parent/child standard here. diff --git a/GOAL_MODE_TEMPLATES.md b/docs/standards/GOAL_MODE_TEMPLATES.md similarity index 100% rename from GOAL_MODE_TEMPLATES.md rename to docs/standards/GOAL_MODE_TEMPLATES.md diff --git a/GOAL_PACKS.md b/docs/standards/GOAL_PACKS.md similarity index 97% rename from GOAL_PACKS.md rename to docs/standards/GOAL_PACKS.md index eacd5d2..8ab98d2 100644 --- a/GOAL_PACKS.md +++ b/docs/standards/GOAL_PACKS.md @@ -82,7 +82,7 @@ In default Goal Mode, Goal Packs are not atomic task packages. Codex still compi - trigger: "Turn this reusable prompt into an accepted standard" - route: `[AI OS]` -> owner project -> `[LLM]` / `[Thinking]` judge-revisor when needed -> `[Codex]` only for repo docs or PR work - input: candidate prompt, owner project, use case, test cases, judge criteria, acceptance constraints -- context needed: `PROMPT_QA_FACTORY.md`, supervised loop boundary, prompt registry/library, owner project rules +- context needed: `docs/standards/PROMPT_QA_FACTORY.md`, supervised loop boundary, prompt registry/library, owner project rules - output: Prompt QA Record with candidate -> test -> judge -> revise -> selected status, UX score, residual risks, and acceptance status - quality gate: supervised only; human-owned acceptance required; no production automation, sensitive data, autonomous retrieval, vector DB, embeddings, semantic search, or auto-merge - done when: prompt is selected by owner acceptance or remains a candidate with visible risks and next revision need @@ -92,7 +92,7 @@ In default Goal Mode, Goal Packs are not atomic task packages. Codex still compi - trigger: "Build a compact context package or prompt from this goal" - route: `[LLM]` -> owner project by output type - input: goal, source files or facts, constraints, expected output, risk level -- context needed: `CONTEXT_PACK_STANDARD.md`, prompt registry, routing rules, raw-dump guardrails +- context needed: `docs/standards/CONTEXT_PACK_STANDARD.md`, prompt registry, routing rules, raw-dump guardrails - output: Context Pack or CTC prompt with goal, facts, constraints, forbidden inputs, expected output, and quality gate - quality gate: curated context only; no raw dumps, source-card dumps, chunks, logs, runtime artifacts, secrets, vector DB, embeddings, semantic search, web UI, or autonomous retrieval - done when: receiving project can act without asking Sergey to rewrite the context from scratch diff --git a/PARENT_CHILD_ISSUE_GATE_STANDARD.md b/docs/standards/PARENT_CHILD_ISSUE_GATE_STANDARD.md similarity index 100% rename from PARENT_CHILD_ISSUE_GATE_STANDARD.md rename to docs/standards/PARENT_CHILD_ISSUE_GATE_STANDARD.md diff --git a/PROMPT_QA_FACTORY.md b/docs/standards/PROMPT_QA_FACTORY.md similarity index 100% rename from PROMPT_QA_FACTORY.md rename to docs/standards/PROMPT_QA_FACTORY.md diff --git a/docs/standards/README.md b/docs/standards/README.md new file mode 100644 index 0000000..9b17874 --- /dev/null +++ b/docs/standards/README.md @@ -0,0 +1,11 @@ +# Shared Standards + +This directory contains active cross-repository standards and reusable +workflows. They apply across ChatGPT Project packages, Codex execution, and +GitHub delivery; they are not owned by one Project folder or the Codex APP +runtime layer. + +Canonical root contracts remain in the repository root when they define the +primary entry flow, routing, handoff semantics, or AES. Use the +[repository map](../REPOSITORY_MAP.md) to find the authoritative document for +each question. diff --git a/knowledge_bundle_manifest.json b/knowledge_bundle_manifest.json index 54e623b..a790a56 100644 --- a/knowledge_bundle_manifest.json +++ b/knowledge_bundle_manifest.json @@ -11,7 +11,7 @@ "ChatGPT/[AI OS]/Knowledge/AI_OS_WORKFLOW.md", "ChatGPT/[AI OS]/Knowledge/KB_USAGE_RULES.md", "ChatGPT/[AI OS]/Knowledge/ANALYTICAL_MEMO_FACTORY_CODEX_APP_WORKFLOW.md", - "EXISTING_SCRIPT_CONTROLLED_REFACTOR_STANDARD.md" + "docs/standards/EXISTING_SCRIPT_CONTROLLED_REFACTOR_STANDARD.md" ], "contract": { "title": "[AI OS] — Routing and Workflow", @@ -72,10 +72,10 @@ "project": "[AI OS]", "output": "ChatGPT/[AI OS]/Knowledge_Bundles/AIOS_04_GOAL_PACKS_AND_COMMAND_SURFACE.md", "sources": [ - "GOAL_PACKS.md", - "COMMAND_SURFACE.md", - "CONTEXT_PACK_STANDARD.md", - "PROMPT_QA_FACTORY.md", + "docs/standards/GOAL_PACKS.md", + "docs/standards/COMMAND_SURFACE.md", + "docs/standards/CONTEXT_PACK_STANDARD.md", + "docs/standards/PROMPT_QA_FACTORY.md", "ChatGPT/[AI OS]/Knowledge/WEEKLY_AI_OS_REVIEW_TEMPLATE.md", "ChatGPT/[AI OS]/Knowledge/ARCHIVE_SUPERSEDED_RULE.md" ], @@ -480,7 +480,7 @@ "project": "[LLM]", "output": "ChatGPT/[LLM]/Knowledge_Bundles/LLM_05_CONTEXT_ENGINEERING.md", "sources": [ - "CONTEXT_PACK_STANDARD.md", + "docs/standards/CONTEXT_PACK_STANDARD.md", "ChatGPT/[LLM]/Knowledge/CONTEXT_ENGINEERING_PLAYBOOK.md", "ChatGPT/[LLM]/Knowledge/CTC_PROMPT_STANDARD.md", "ChatGPT/[LLM]/Knowledge/CONTEXT_INTAKE_CHECKLIST.md", @@ -589,7 +589,7 @@ "ChatGPT/[Codex]/Knowledge/ANALYTICAL_MEMO_AUTOMATION_WORKFLOW.md", "ChatGPT/[Codex]/Knowledge/ANALYTICAL_TECHNIQUES_FOR_CODEX.md", "ChatGPT/[AI OS]/Knowledge/ANALYTICAL_MEMO_FACTORY_CODEX_APP_WORKFLOW.md", - "EXISTING_SCRIPT_CONTROLLED_REFACTOR_STANDARD.md" + "docs/standards/EXISTING_SCRIPT_CONTROLLED_REFACTOR_STANDARD.md" ], "contract": { "title": "[Codex] — Implementation Workflows", diff --git a/scripts/check_codex_goal_mode_defaults.py b/scripts/check_codex_goal_mode_defaults.py index c267cca..0d3aade 100644 --- a/scripts/check_codex_goal_mode_defaults.py +++ b/scripts/check_codex_goal_mode_defaults.py @@ -42,9 +42,9 @@ "AGENTS.md", "README.md", "GOAL_MODE.md", - "GOAL_PACKS.md", - "COMMAND_SURFACE.md", - "CONTEXT_PACK_STANDARD.md", + "docs/standards/GOAL_PACKS.md", + "docs/standards/COMMAND_SURFACE.md", + "docs/standards/CONTEXT_PACK_STANDARD.md", "ChatGPT/[AI OS]/PROJECT_INSTRUCTIONS.md", "ChatGPT/[AI OS]/Knowledge", "ChatGPT/[AI OS]/Knowledge_Bundles", diff --git a/tests/test_aios_dual_surface.py b/tests/test_aios_dual_surface.py index 140dd02..07a12c2 100644 --- a/tests/test_aios_dual_surface.py +++ b/tests/test_aios_dual_surface.py @@ -224,7 +224,7 @@ def test_missing_canonical_path_blocks_before_context_loading(tmp_path: Path) -> def test_orchestrator_is_the_default_goal_entrypoint() -> None: agents = (REPO_ROOT / "AGENTS.md").read_text(encoding="utf-8") goal_mode = (REPO_ROOT / "GOAL_MODE.md").read_text(encoding="utf-8") - commands = (REPO_ROOT / "COMMAND_SURFACE.md").read_text(encoding="utf-8") + commands = (REPO_ROOT / "docs/standards/COMMAND_SURFACE.md").read_text(encoding="utf-8") assert "use `ai-os-orchestrator` as the default entrypoint" in agents assert "Simple local, reversible repository work" in agents diff --git a/tests/test_merge_gate_protection.py b/tests/test_merge_gate_protection.py index 2ec610a..5152e54 100644 --- a/tests/test_merge_gate_protection.py +++ b/tests/test_merge_gate_protection.py @@ -64,7 +64,7 @@ def test_representative_governance_paths_require_owner_review() -> None: "AUTONOMOUS_EXECUTION_EXTENSION_CONTRACT.md", "ROUTING_RULES.md", "HANDOFF_STYLE_STANDARD.md", - "PROMPT_QA_FACTORY.md", + "docs/standards/PROMPT_QA_FACTORY.md", "PROJECT_CAPABILITIES.yaml", "knowledge_bundle_manifest.json", "docs/operations/CHATGPT_PROJECT_SYNC_CHECKLIST.md", diff --git a/tests/test_validation_scripts.py b/tests/test_validation_scripts.py index 2b78dd2..fb6cfe9 100644 --- a/tests/test_validation_scripts.py +++ b/tests/test_validation_scripts.py @@ -606,7 +606,7 @@ def test_merge_gate_protected_paths_match_codeowners_roots() -> None: "/AUTONOMOUS_EXECUTION_EXTENSION_CONTRACT.md", "/ROUTING_RULES.md", "/HANDOFF_STYLE_STANDARD.md", - "/PROMPT_QA_FACTORY.md", + "/docs/standards/PROMPT_QA_FACTORY.md", "/PROJECT_CAPABILITIES.yaml", "/knowledge_bundle_manifest.json", "/docs/operations/CHATGPT_PROJECT_SYNC_CHECKLIST.md",