codex-orchestrator 2.0.1 → 2.0.3

package/internal-workflow/docs/agents/tool-usage.md

@@ -0,0 +1,88 @@
+# Tool Usage
+
+## Flutter Debug Sessions
+
+Local Flutter UI work always uses a platform QA skill plus the runtime ownership gate:
+
+- Android emulator: use `$flutter-android-debug` as the lifecycle orchestrator and
+  `test-android-apps:android-emulator-qa` for navigation, interaction, UI trees,
+  screenshots, and logcat.
+- iOS Simulator: use `$flutter-ios-debug` for environment/login gates, navigation,
+  interaction, screenshots, and visual comparison.
+- Use `$flutter-attach-session` only to discover the runtime owner and perform
+  reload/restart when that session is safe for this agent to control.
+
+Before any install, launch, attach, reload, restart, terminate, or force-stop:
+
+1. Identify the project, target device, package/app, current PID, VM Service, runtime
+   owner, and expected backend/environment.
+2. Treat any live PID, VM Service, IDE debug adapter, `flutter run`, or visible app as
+   user-owned state.
+3. If an IDE/debug adapter or machine run owns DevFS, do not create a second attach
+   controller. Use the owning IDE/terminal reload action or ask the user to trigger it.
+   A standalone interactive terminal run is the only exception, and only when
+   discovery marks it attach-safe and the helper receives its confirmed PID.
+4. Use `r` for widget/layout/style/rendering changes and `R` for startup state,
+   dependency injection, providers, globals, routes, or initialization changes.
+5. For a safely attachable standalone runtime, pass the PID confirmed by
+   `discover --json` as `--expected-pid`; never execute the raw discovered attach command.
+6. Verify that the same PID and expected environment remain after each runtime or
+   navigation action.
+
+Requests to inspect, debug, navigate, capture screenshots, or verify UI do not authorize
+build/install, uninstall, app-data clearing, force-stop, process termination, replacement
+launch, or a new `flutter run`. Use those only when no live target exists and the user
+requested a fresh run, or after explicit approval to replace the current session.
+
+The platform QA skill owns navigation and evidence. Do not replace it with ad-hoc shell
+commands: use `test-android-apps:android-emulator-qa` for Android emulator UI trees,
+input, screenshots, and logcat, and `$flutter-ios-debug` for iOS Simulator environment
+gates, navigation, interaction, screenshots, and visual comparison.
+
+If the process disappears, stop and report it. Hot reload cannot restore a dead process,
+and launching the installed app may expose an older APK/IPA without the DevFS changes.
+
+For a cold launch, load the owning repository's launch configuration as the source of
+truth for flavor, dart-defines, package/app identity, and backend. This applies only
+after the cold-launch gate is satisfied.
+
+## External Research
+
+Prefer local evidence before external lookup. When external evidence is
+material to a coding decision, use the source that owns the claim:
+
+1. official documentation or specifications;
+2. first-party source code, changelogs, release notes, or issue trackers;
+3. first-party APIs or published schemas.
+
+Use secondary sources only to discover primary sources or identify a disputed
+interpretation. Record source version/date when freshness matters, separate
+sourced facts from inference, and say when current behavior cannot be confirmed.
+
+Keep one narrow lookup inline unless the user explicitly requests delegation or
+a durable artifact. Use `$research` for either explicit request, multi-source
+comparison, or material external contract synthesis. The skill owns the
+Research Capsule, named-agent route, claim-to-source artifact, root verification,
+and downstream handoff.
+
+## Context7
+
+Use Context7 only when the task genuinely requires precise, current documentation for a real package, framework, SDK, API, or implementation detail that cannot be confidently answered from local evidence or built-in knowledge.
+
+Prefer local inspection first:
+
+- source code
+- lockfiles and installed package versions
+- package manifests
+- existing tests and examples
+- local docs and configuration
+
+Do not use Context7 for:
+
+- routine coding
+- general language questions
+- simple refactors
+- repository-specific behavior
+- facts already visible in the project
+
+If Context7 is used, keep the lookup narrow and bring back only the details needed for the active task.

package/internal-workflow/manifest.json

@@ -0,0 +1 @@
+{"files":[{"mode":420,"path":"docs/agents/artifact-review-loop.md","sha256":"3b580da704595fa031998fb08caaf54eba3402695b9dc29952575d62d4d86e61","size":12420},{"mode":420,"path":"docs/agents/bug-workflow-routing.md","sha256":"a37c59676bcb8b938a7c82bce8a6ea5becf58ba367866d2712cd469391aea931","size":1603},{"mode":420,"path":"docs/agents/coding-skill-routing.md","sha256":"cb90ba59c007a9438a3ea9f03953e707d8a22fa23e040a3e6072eb8036d7b703","size":13909},{"mode":420,"path":"docs/agents/confidence-rubric.md","sha256":"42c947db2775380867e7adcfbdbe0f67b8f511b9ddf33a6eef8e1b0e995912c2","size":1883},{"mode":420,"path":"docs/agents/contract-test-ledger.md","sha256":"6f2327a40f218fbc746193c6440a69be08450938688b401f05163a3bb438a7f3","size":3779},{"mode":420,"path":"docs/agents/implementation-review-loop.md","sha256":"afbc1430fa6ea9f6edf0cc8c0d5f8079047411e5269f43fdb5c9533be71ce9ad","size":15270},{"mode":420,"path":"docs/agents/review-gates.md","sha256":"15d2265dbdccd1040a77c11e7b95fe66fc1139e657e6765ce1cc151e5d4b868b","size":2410},{"mode":420,"path":"docs/agents/review-protocol.md","sha256":"daab893e86841737892366a6da1df5226b2b666fcaf667b8479900f529ba7d55","size":8918},{"mode":420,"path":"docs/agents/tool-usage.md","sha256":"b6ade11865a46a5a28d4823c1b70318453f4d350cfc62d2969aa06d73c47be4b","size":4321},{"mode":420,"path":"operations/acceptance-proof/SKILL.md","sha256":"19445e1810ff3e5782ac27c17ad5f35a85a05a77ecc384624821f8298af6a7db","size":166},{"mode":420,"path":"operations/ambiguity-review/SKILL.md","sha256":"3b7506473b4d5ddcd9f827350d6da9216291e6dc62a6636c5f773d756053b086","size":346},{"mode":420,"path":"operations/cleanup-review/SKILL.md","sha256":"6d01e8a4ddf1b3363ff8b7793e496f6933ede4ff629b1a7b2474bd8a20697a7e","size":162},{"mode":420,"path":"operations/code-review/SKILL.md","sha256":"627e786c9489305a8431c564e9342f0e040c4ced29289aa21dade268fe370e39","size":156},{"mode":420,"path":"operations/implementation/SKILL.md","sha256":"0791d4593f0b8a6465f9916bfd23116097cf2eefed0c715c506e450e1eac62d4","size":165},{"mode":420,"path":"operations/spec-author/SKILL.md","sha256":"7750a639a0b8db0cd93be4057c91ee508dc72502b90ac57a363c655ba08a62ca","size":206},{"mode":420,"path":"operations/spec-implementation/SKILL.md","sha256":"46e42f702514b25d2935d251ca7748a083f28c60353fb19058c03f8826aaa6ea","size":196},{"mode":420,"path":"operations/spec-review/SKILL.md","sha256":"dde1323508b5024074f2f0e052bcf69fbebebe7bb1f46708b6b484720342f56a","size":161},{"mode":420,"path":"operations/triage/SKILL.md","sha256":"6e7aca4b35b3532a4bcda3dca8b69149bd0bf5527217093b6dfe0fb89fa4a409","size":182},{"mode":420,"path":"profiles/analyst_deep.toml","sha256":"06335e3a13b07ef3d7deb9b546a6dad5d765edfa6dbf21c1c4d516e843a4352f","size":380},{"mode":420,"path":"profiles/implementer_deep.toml","sha256":"f6b306fec4de431029dde01ae4236797ff200c8c8b24dd52ebe33bbd7d5f1ed9","size":849},{"mode":420,"path":"profiles/implementer_standard.toml","sha256":"4074f45ea6fb615382de7ddf04e4ab824185e01932290b95764ff63a3711824e","size":750},{"mode":420,"path":"profiles/proof_agent.toml","sha256":"2fbaf1145a11cb5c574bf1ed7333187d284ed0c3c3d6260c628f82057b8b04e7","size":446},{"mode":420,"path":"profiles/researcher_standard.toml","sha256":"ff9d47e27f3a8673e44798ffab0ec28f5fa6ed4eb5b2b5b052ce90151aecb36b","size":929},{"mode":420,"path":"profiles/reviewer_deep.toml","sha256":"15ef121b641265a85d0647c46f6dd93d4a9abd8c09bcc746c41e4ca6b4c9af41","size":648},{"mode":420,"path":"profiles/reviewer_fast.toml","sha256":"85562db714eca4dabaf64a6a989797ec54ccd3032a04392963aac8ac100d5d81","size":581},{"mode":420,"path":"profiles/reviewer_standard.toml","sha256":"0a26b24f98b7e8d0ec049cb6fbe623d5da838b2fe71b5accd59bf364a9c97e5c","size":585},{"mode":420,"path":"schemas/ambiguity-review-v1.json","sha256":"48d946ad8e91bd1908d8993ef631b1701ad3cd7a79f34368a07942d7774afeff","size":524},{"mode":420,"path":"schemas/code-review-v1.json","sha256":"8664163c561c98df6842e485a24d12b7857add95aeb75c54eb400536b5f85a19","size":2573},{"mode":420,"path":"schemas/implementation-report-v1.json","sha256":"a1b580dad03af9be74d895d38a2f6aa9398b6d772c944dc398dac5aca0630d2e","size":1573},{"mode":420,"path":"schemas/proof-report-v1.json","sha256":"e02812f0fd882cb29bb634b61a955b8dcd7d42794010201b7e0a1d6260a0f0d5","size":10280},{"mode":420,"path":"schemas/spec-author-v1.json","sha256":"49f945362d1184ad628584b91fbbe75323d13bafa4ca3876093387a9fca06214","size":420},{"mode":420,"path":"schemas/spec-review-v1.json","sha256":"fe9fdd389bcb4c3b7d19609184caf3af4b89e7c1d1e71a7ba0c55c72c5d5562d","size":1386},{"mode":420,"path":"schemas/triage-route-v1.json","sha256":"3ca7ed29237f42e12567797d145d90dd4f1f48fa1e81a7da67434c19747753d8","size":5894},{"mode":420,"path":"skills/acceptance-proof/SKILL.md","sha256":"5a0f2dcd62a43da86a7627c70c86bde86e78c06929675073ee37727e3f06fc65","size":1683},{"mode":420,"path":"skills/acceptance-proof/agents/openai.yaml","sha256":"d602d9f2e1bf618a71171729c6f354dd137c939cb433bd49afec678360e1189f","size":265},{"mode":420,"path":"skills/acceptance-proof/references/android.md","sha256":"b9396d1327ffc19f91b73c2470222871e403ea1d0f3de58025e689a92691a842","size":3022},{"mode":420,"path":"skills/acceptance-proof/references/browser.md","sha256":"ceefa4fd7db475b6162368511c2742b6d9c6af58d48e7d5d8a773ed5cc3938c4","size":2281},{"mode":420,"path":"skills/acceptance-proof/references/ios.md","sha256":"ae18be2632e1f7c3aa0810a1bafafc7760c807b30b1269408825aa14c224d493","size":2486},{"mode":420,"path":"skills/acceptance-proof/tools/android-lease.mjs","sha256":"982c426dd5b3a90f74e5120783b3a24fa98d8218d0f4140e756187865b48d708","size":11393},{"mode":420,"path":"skills/acceptance-proof/tools/ios-lease.mjs","sha256":"6e1e0d95c6a8b2d42c34de05bd4446eac23e3916bffccb027f236b8a8a1809a3","size":13834},{"mode":420,"path":"skills/agent-auto/SKILL.md","sha256":"5b80918ec9de52fe033dfccc75e3b68b9f1a09c5f1c2664c7d481dd18dc96664","size":1225},{"mode":420,"path":"skills/agent-auto/agents/openai.yaml","sha256":"79a70421300891e3130fc7535c4aa37e01931ff353fbd7b83262c6fcf2032b71","size":266},{"mode":420,"path":"skills/cleanup-review/SKILL.md","sha256":"85019d95a6b89701ca23845c042bc22f0c63b45b304d6589565e3657dabd7c8f","size":5218},{"mode":420,"path":"skills/cleanup-review/agents/openai.yaml","sha256":"9d8f8bba6586bcdf8acf5fc9ee174995c12eece56601ed29198435b5fa3a3665","size":288},{"mode":420,"path":"skills/code-review/SKILL.md","sha256":"af50264fbd83a9eb2038bba1bda327804da2f5a8dabf17b30f86765549272ebf","size":14344},{"mode":420,"path":"skills/code-review/agents/openai.yaml","sha256":"c2697212427a5e119d9127e2f9000594e6c2eb7696e7a40604da7149c79ce478","size":278},{"mode":420,"path":"skills/code-review/references/bug-classes.md","sha256":"1f8648af9914cbd7553d045915f959df0f3b50a88e97c3beefeb955342e7b12d","size":4062},{"mode":420,"path":"skills/code-review/references/framework-lenses.md","sha256":"ca9e7cb09f32f729cec5522e8ff7c7dcc43f76ef986e701e9c0a226514912cd8","size":1820},{"mode":420,"path":"skills/code-review/references/targeted-recipes.md","sha256":"921b422958c97e606637d3fa2d2628239d9176f0316c7e45bbc55b20a22fe3c1","size":2564},{"mode":420,"path":"skills/codebase-design/DEEPENING.md","sha256":"afa68a77f4f3199a22f5d1800a4592034edefc4980367adc91b53d5738ec3dfd","size":1899},{"mode":420,"path":"skills/codebase-design/DESIGN-IT-TWICE.md","sha256":"dff3a61e68b38b82917e397123e2ea545368d827d336a391081bf9bc3cf297ac","size":2656},{"mode":420,"path":"skills/codebase-design/SKILL.md","sha256":"fe6bce73dfd9fc0fedb9ae635c2fcb6a4cdc686be46b9fbd30d5088cf82ae45e","size":4627},{"mode":420,"path":"skills/codebase-design/agents/openai.yaml","sha256":"6e89c19d29ccebd5ab74a133e345fec04a3891eb0ceb5686ea8c0a76ae8d23aa","size":369},{"mode":420,"path":"skills/diagnosing-bugs/SKILL.md","sha256":"9a3457d4f12e3810041def93456a0c020df0842200737bf7ecaf06471991c16c","size":9097},{"mode":420,"path":"skills/diagnosing-bugs/agents/openai.yaml","sha256":"eca84840bc193ce63cc7aad93d9e7b5f2541739b7bf682e5fa9eded3a8060787","size":262},{"mode":420,"path":"skills/diagnosing-bugs/scripts/hitl-loop.template.sh","sha256":"b2932630950e5210075bcd6f850e5accf30c101c5367b29eac3a29b4dd8084c8","size":1164},{"mode":420,"path":"skills/implementation-spec-maker/SKILL.md","sha256":"4be042b3348e74119f9c2857fcdc759e9585605be3aa4ec4196affaf642bc90d","size":7526},{"mode":420,"path":"skills/implementation-spec-maker/agents/openai.yaml","sha256":"a4457f3e2f08cb07694855d362103b6a628c82b262950409268145348e2d91dd","size":363},{"mode":420,"path":"skills/implementation-spec-maker/references/source-modes.md","sha256":"471f0f58668b414438effbf91398022327fcbd43f40cc0801080994fe02bda3b","size":1920},{"mode":420,"path":"skills/implementation-spec-maker/references/spec-template.md","sha256":"46874dcd247a4f5d30b81453ae5a7f6758861b3bc346f30ae3a1d9dec0853bea","size":5308},{"mode":420,"path":"skills/implementation-spec-review/SKILL.md","sha256":"bd5a86063b90aae3b0c381bf7a959b4166d0e9445de03e72df6ae1e617b5d790","size":16135},{"mode":420,"path":"skills/implementation-spec-review/agents/openai.yaml","sha256":"600f9cc4e4f42596e3bf48601a508ddf055efcc396478d5e339d024973f4fb05","size":277},{"mode":420,"path":"skills/research/SKILL.md","sha256":"04ff21cf57c1044ff1ce98cfa5c5baf9d4ffa7dd32f06be833e38af94d02e7eb","size":4593},{"mode":420,"path":"skills/research/agents/openai.yaml","sha256":"4475cf777225f81a1c45937389d55f2b485b039b36e8378ef6b001e24f3fd1fe","size":254},{"mode":420,"path":"skills/small-task-implementer/SKILL.md","sha256":"137436142da6abe5565f4d24a94e515e4a239decd0710264872b25b30375e71d","size":4105},{"mode":420,"path":"skills/small-task-implementer/agents/openai.yaml","sha256":"81569b6dfd97de60b53f092528140a5e5043f9adcc9262debff7bc912e278958","size":261},{"mode":420,"path":"skills/spec-implementer/SKILL.md","sha256":"7095c732407a12e5f2fb25418df57ebe8ec8de7833e4091d3d87f44e1513beca","size":14590},{"mode":420,"path":"skills/spec-implementer/agents/openai.yaml","sha256":"84ef664ae3538e264fe6746917f081d34eac0738dc28764ddf27d7a448b3615d","size":341},{"mode":420,"path":"skills/tdd/SKILL.md","sha256":"ce19907ebfa2f1f8688359fbbee334a069def61e5341967527c8eebb8d996373","size":3461},{"mode":420,"path":"skills/tdd/agents/openai.yaml","sha256":"29e15aec650cf5ab74ae44485d2eef820d2c384b575c14957adda8f3dae9f66d","size":275},{"mode":420,"path":"skills/tdd/interface-design.md","sha256":"764c5ff0e3fa6b4ab7095eb65ccc7201e090baf19fa16051dfdb72c06d27417d","size":653},{"mode":420,"path":"skills/tdd/mocking.md","sha256":"3ceb807fdf4a47d6a93d4d9a891e5ba6d362a6247bd08adc451feebfc17361ef","size":1481},{"mode":420,"path":"skills/tdd/refactoring.md","sha256":"54fced22dd1911b7094c3fe7979b7c1a40d40be307482c4adf7dc0588f27d6cc","size":387},{"mode":420,"path":"skills/tdd/tests.md","sha256":"6773173a074569b2e51653bd7b95c097d602dbb4815d1cf1c87344705c4e0d1c","size":2228},{"mode":420,"path":"skills/triage/AGENT-BRIEF.md","sha256":"053cd013e1c2c9275111aa6e4b5a12e9838f8d6cd888e8ca0ccaaac576fd74df","size":7070},{"mode":420,"path":"skills/triage/OUT-OF-SCOPE.md","sha256":"8ed8cf27833444060c81b3961a83c0e3d8e6cf2fcb2ddf6f8b07c6655cbb0d85","size":4282},{"mode":420,"path":"skills/triage/SKILL.md","sha256":"5c7c84189fd5146ec1ae55a5669c74372ed7bce588fa7b8523417aa55b312a2e","size":8273},{"mode":420,"path":"skills/triage/agents/openai.yaml","sha256":"466bc430f95132bc6b28d077d50865d4b1fd9218307582343c35b0baf66d7894","size":283},{"mode":420,"path":"skills/ui-evidence-proof/SKILL.md","sha256":"06c2087b6b2df5265d1fe47b3f87dce1b5dc581c15c05176377741785572c1ad","size":6235},{"mode":420,"path":"skills/ui-evidence-proof/agents/openai.yaml","sha256":"0835da6b3a0439f515f1691748d6cf810b421fd58b24de8bc6b1f03b0d5e3c2e","size":374}],"generationHash":"df5ba62363dd5dd1eb502b036b34e8d10a2a4b5df59115ca21f40cca29d770e5","operations":{"acceptance-proof":{"entry":"operations/acceptance-proof/SKILL.md","files":["docs/agents/artifact-review-loop.md","docs/agents/bug-workflow-routing.md","docs/agents/coding-skill-routing.md","docs/agents/confidence-rubric.md","docs/agents/contract-test-ledger.md","docs/agents/implementation-review-loop.md","docs/agents/review-gates.md","docs/agents/review-protocol.md","docs/agents/tool-usage.md","operations/acceptance-proof/SKILL.md","profiles/proof_agent.toml","schemas/proof-report-v1.json","skills/acceptance-proof/SKILL.md","skills/acceptance-proof/agents/openai.yaml","skills/acceptance-proof/references/android.md","skills/acceptance-proof/references/browser.md","skills/acceptance-proof/references/ios.md","skills/acceptance-proof/tools/android-lease.mjs","skills/acceptance-proof/tools/ios-lease.mjs"],"id":"acceptance-proof","outputSchema":"schemas/proof-report-v1.json","policy":{"approvalCeiling":"never","cwdClass":"worktree","externalWrite":false,"mcpTools":[],"network":"deny","networkHosts":[],"runnerPostcondition":"proof-only","sandboxMode":"workspace-write","worktreeAccess":"write","writableRootClasses":["worktree"]},"profile":"proof_agent","sourceSkill":"acceptance-proof"},"ambiguity-review":{"entry":"operations/ambiguity-review/SKILL.md","files":["operations/ambiguity-review/SKILL.md","profiles/reviewer_deep.toml","schemas/ambiguity-review-v1.json"],"id":"ambiguity-review","outputSchema":"schemas/ambiguity-review-v1.json","policy":{"approvalCeiling":"never","cwdClass":"worktree","externalWrite":false,"mcpTools":[],"network":"deny","networkHosts":[],"runnerPostcondition":"report-only","sandboxMode":"read-only","worktreeAccess":"read-only","writableRootClasses":[]},"profile":"reviewer_deep","sourceSkill":null},"cleanup-review":{"entry":"operations/cleanup-review/SKILL.md","files":["docs/agents/artifact-review-loop.md","docs/agents/bug-workflow-routing.md","docs/agents/coding-skill-routing.md","docs/agents/confidence-rubric.md","docs/agents/contract-test-ledger.md","docs/agents/implementation-review-loop.md","docs/agents/review-gates.md","docs/agents/review-protocol.md","docs/agents/tool-usage.md","operations/cleanup-review/SKILL.md","profiles/reviewer_standard.toml","schemas/code-review-v1.json","skills/cleanup-review/SKILL.md","skills/cleanup-review/agents/openai.yaml"],"id":"cleanup-review","outputSchema":"schemas/code-review-v1.json","policy":{"approvalCeiling":"never","cwdClass":"worktree","externalWrite":false,"mcpTools":[],"network":"deny","networkHosts":[],"runnerPostcondition":"report-only","sandboxMode":"read-only","worktreeAccess":"read-only","writableRootClasses":[]},"profile":"reviewer_standard","sourceSkill":"cleanup-review"},"code-review":{"entry":"operations/code-review/SKILL.md","files":["docs/agents/artifact-review-loop.md","docs/agents/bug-workflow-routing.md","docs/agents/coding-skill-routing.md","docs/agents/confidence-rubric.md","docs/agents/contract-test-ledger.md","docs/agents/implementation-review-loop.md","docs/agents/review-gates.md","docs/agents/review-protocol.md","docs/agents/tool-usage.md","operations/code-review/SKILL.md","profiles/reviewer_deep.toml","schemas/code-review-v1.json","skills/code-review/SKILL.md","skills/code-review/agents/openai.yaml","skills/code-review/references/bug-classes.md","skills/code-review/references/framework-lenses.md","skills/code-review/references/targeted-recipes.md"],"id":"code-review","outputSchema":"schemas/code-review-v1.json","policy":{"approvalCeiling":"never","cwdClass":"worktree","externalWrite":false,"mcpTools":[],"network":"deny","networkHosts":[],"runnerPostcondition":"report-only","sandboxMode":"read-only","worktreeAccess":"read-only","writableRootClasses":[]},"profile":"reviewer_deep","sourceSkill":"code-review"},"implementation":{"entry":"operations/implementation/SKILL.md","files":["docs/agents/artifact-review-loop.md","docs/agents/bug-workflow-routing.md","docs/agents/coding-skill-routing.md","docs/agents/confidence-rubric.md","docs/agents/contract-test-ledger.md","docs/agents/implementation-review-loop.md","docs/agents/review-gates.md","docs/agents/review-protocol.md","docs/agents/tool-usage.md","operations/implementation/SKILL.md","profiles/implementer_standard.toml","schemas/implementation-report-v1.json","skills/agent-auto/SKILL.md","skills/agent-auto/agents/openai.yaml"],"id":"implementation","outputSchema":"schemas/implementation-report-v1.json","policy":{"approvalCeiling":"never","cwdClass":"worktree","externalWrite":false,"mcpTools":[],"network":"deny","networkHosts":[],"runnerPostcondition":"change-set","sandboxMode":"workspace-write","worktreeAccess":"write","writableRootClasses":["worktree"]},"profile":"implementer_standard","sourceSkill":"agent-auto"},"spec-author":{"entry":"operations/spec-author/SKILL.md","files":["docs/agents/artifact-review-loop.md","docs/agents/bug-workflow-routing.md","docs/agents/coding-skill-routing.md","docs/agents/confidence-rubric.md","docs/agents/contract-test-ledger.md","docs/agents/implementation-review-loop.md","docs/agents/review-gates.md","docs/agents/review-protocol.md","docs/agents/tool-usage.md","operations/spec-author/SKILL.md","profiles/implementer_standard.toml","schemas/spec-author-v1.json","skills/implementation-spec-maker/SKILL.md","skills/implementation-spec-maker/agents/openai.yaml","skills/implementation-spec-maker/references/source-modes.md","skills/implementation-spec-maker/references/spec-template.md"],"id":"spec-author","outputSchema":"schemas/spec-author-v1.json","policy":{"approvalCeiling":"never","cwdClass":"target-state","externalWrite":false,"mcpTools":[],"network":"deny","networkHosts":[],"runnerPostcondition":"spec-only","sandboxMode":"workspace-write","worktreeAccess":"write","writableRootClasses":["target-state"]},"profile":"implementer_standard","sourceSkill":"implementation-spec-maker"},"spec-implementation":{"entry":"operations/spec-implementation/SKILL.md","files":["docs/agents/artifact-review-loop.md","docs/agents/bug-workflow-routing.md","docs/agents/coding-skill-routing.md","docs/agents/confidence-rubric.md","docs/agents/contract-test-ledger.md","docs/agents/implementation-review-loop.md","docs/agents/review-gates.md","docs/agents/review-protocol.md","docs/agents/tool-usage.md","operations/spec-implementation/SKILL.md","profiles/implementer_standard.toml","schemas/implementation-report-v1.json","skills/spec-implementer/SKILL.md","skills/spec-implementer/agents/openai.yaml"],"id":"spec-implementation","outputSchema":"schemas/implementation-report-v1.json","policy":{"approvalCeiling":"never","cwdClass":"worktree","externalWrite":false,"mcpTools":[],"network":"deny","networkHosts":[],"runnerPostcondition":"change-set","sandboxMode":"workspace-write","worktreeAccess":"write","writableRootClasses":["worktree"]},"profile":"implementer_standard","sourceSkill":"spec-implementer"},"spec-review":{"entry":"operations/spec-review/SKILL.md","files":["docs/agents/artifact-review-loop.md","docs/agents/bug-workflow-routing.md","docs/agents/coding-skill-routing.md","docs/agents/confidence-rubric.md","docs/agents/contract-test-ledger.md","docs/agents/implementation-review-loop.md","docs/agents/review-gates.md","docs/agents/review-protocol.md","docs/agents/tool-usage.md","operations/spec-review/SKILL.md","profiles/reviewer_deep.toml","schemas/spec-review-v1.json","skills/implementation-spec-review/SKILL.md","skills/implementation-spec-review/agents/openai.yaml"],"id":"spec-review","outputSchema":"schemas/spec-review-v1.json","policy":{"approvalCeiling":"never","cwdClass":"worktree","externalWrite":false,"mcpTools":[],"network":"deny","networkHosts":[],"runnerPostcondition":"report-only","sandboxMode":"read-only","worktreeAccess":"read-only","writableRootClasses":[]},"profile":"reviewer_deep","sourceSkill":"implementation-spec-review"},"triage":{"entry":"operations/triage/SKILL.md","files":["docs/agents/artifact-review-loop.md","docs/agents/bug-workflow-routing.md","docs/agents/coding-skill-routing.md","docs/agents/confidence-rubric.md","docs/agents/contract-test-ledger.md","docs/agents/implementation-review-loop.md","docs/agents/review-gates.md","docs/agents/review-protocol.md","docs/agents/tool-usage.md","operations/triage/SKILL.md","profiles/analyst_deep.toml","schemas/triage-route-v1.json","skills/triage/AGENT-BRIEF.md","skills/triage/OUT-OF-SCOPE.md","skills/triage/SKILL.md","skills/triage/agents/openai.yaml"],"id":"triage","outputSchema":"schemas/triage-route-v1.json","policy":{"approvalCeiling":"never","cwdClass":"worktree","externalWrite":false,"mcpTools":[],"network":"deny","networkHosts":[],"runnerPostcondition":"report-only","sandboxMode":"read-only","worktreeAccess":"read-only","writableRootClasses":[]},"profile":"analyst_deep","sourceSkill":"triage"}},"profiles":{"analyst_deep":"profiles/analyst_deep.toml","implementer_deep":"profiles/implementer_deep.toml","implementer_standard":"profiles/implementer_standard.toml","proof_agent":"profiles/proof_agent.toml","researcher_standard":"profiles/researcher_standard.toml","reviewer_deep":"profiles/reviewer_deep.toml","reviewer_fast":"profiles/reviewer_fast.toml","reviewer_standard":"profiles/reviewer_standard.toml"},"skills":{"acceptance-proof":{"entry":"skills/acceptance-proof/SKILL.md","files":["docs/agents/artifact-review-loop.md","docs/agents/bug-workflow-routing.md","docs/agents/coding-skill-routing.md","docs/agents/confidence-rubric.md","docs/agents/contract-test-ledger.md","docs/agents/implementation-review-loop.md","docs/agents/review-gates.md","docs/agents/review-protocol.md","docs/agents/tool-usage.md","skills/acceptance-proof/SKILL.md","skills/acceptance-proof/agents/openai.yaml","skills/acceptance-proof/references/android.md","skills/acceptance-proof/references/browser.md","skills/acceptance-proof/references/ios.md","skills/acceptance-proof/tools/android-lease.mjs","skills/acceptance-proof/tools/ios-lease.mjs"],"metadata":"skills/acceptance-proof/agents/openai.yaml"},"agent-auto":{"entry":"skills/agent-auto/SKILL.md","files":["docs/agents/artifact-review-loop.md","docs/agents/bug-workflow-routing.md","docs/agents/coding-skill-routing.md","docs/agents/confidence-rubric.md","docs/agents/contract-test-ledger.md","docs/agents/implementation-review-loop.md","docs/agents/review-gates.md","docs/agents/review-protocol.md","docs/agents/tool-usage.md","skills/agent-auto/SKILL.md","skills/agent-auto/agents/openai.yaml"],"metadata":"skills/agent-auto/agents/openai.yaml"},"cleanup-review":{"entry":"skills/cleanup-review/SKILL.md","files":["docs/agents/artifact-review-loop.md","docs/agents/bug-workflow-routing.md","docs/agents/coding-skill-routing.md","docs/agents/confidence-rubric.md","docs/agents/contract-test-ledger.md","docs/agents/implementation-review-loop.md","docs/agents/review-gates.md","docs/agents/review-protocol.md","docs/agents/tool-usage.md","skills/cleanup-review/SKILL.md","skills/cleanup-review/agents/openai.yaml"],"metadata":"skills/cleanup-review/agents/openai.yaml"},"code-review":{"entry":"skills/code-review/SKILL.md","files":["docs/agents/artifact-review-loop.md","docs/agents/bug-workflow-routing.md","docs/agents/coding-skill-routing.md","docs/agents/confidence-rubric.md","docs/agents/contract-test-ledger.md","docs/agents/implementation-review-loop.md","docs/agents/review-gates.md","docs/agents/review-protocol.md","docs/agents/tool-usage.md","skills/code-review/SKILL.md","skills/code-review/agents/openai.yaml","skills/code-review/references/bug-classes.md","skills/code-review/references/framework-lenses.md","skills/code-review/references/targeted-recipes.md"],"metadata":"skills/code-review/agents/openai.yaml"},"codebase-design":{"entry":"skills/codebase-design/SKILL.md","files":["docs/agents/artifact-review-loop.md","docs/agents/bug-workflow-routing.md","docs/agents/coding-skill-routing.md","docs/agents/confidence-rubric.md","docs/agents/contract-test-ledger.md","docs/agents/implementation-review-loop.md","docs/agents/review-gates.md","docs/agents/review-protocol.md","docs/agents/tool-usage.md","skills/codebase-design/DEEPENING.md","skills/codebase-design/DESIGN-IT-TWICE.md","skills/codebase-design/SKILL.md","skills/codebase-design/agents/openai.yaml"],"metadata":"skills/codebase-design/agents/openai.yaml"},"diagnosing-bugs":{"entry":"skills/diagnosing-bugs/SKILL.md","files":["docs/agents/artifact-review-loop.md","docs/agents/bug-workflow-routing.md","docs/agents/coding-skill-routing.md","docs/agents/confidence-rubric.md","docs/agents/contract-test-ledger.md","docs/agents/implementation-review-loop.md","docs/agents/review-gates.md","docs/agents/review-protocol.md","docs/agents/tool-usage.md","skills/diagnosing-bugs/SKILL.md","skills/diagnosing-bugs/agents/openai.yaml","skills/diagnosing-bugs/scripts/hitl-loop.template.sh"],"metadata":"skills/diagnosing-bugs/agents/openai.yaml"},"implementation-spec-maker":{"entry":"skills/implementation-spec-maker/SKILL.md","files":["docs/agents/artifact-review-loop.md","docs/agents/bug-workflow-routing.md","docs/agents/coding-skill-routing.md","docs/agents/confidence-rubric.md","docs/agents/contract-test-ledger.md","docs/agents/implementation-review-loop.md","docs/agents/review-gates.md","docs/agents/review-protocol.md","docs/agents/tool-usage.md","skills/implementation-spec-maker/SKILL.md","skills/implementation-spec-maker/agents/openai.yaml","skills/implementation-spec-maker/references/source-modes.md","skills/implementation-spec-maker/references/spec-template.md"],"metadata":"skills/implementation-spec-maker/agents/openai.yaml"},"implementation-spec-review":{"entry":"skills/implementation-spec-review/SKILL.md","files":["docs/agents/artifact-review-loop.md","docs/agents/bug-workflow-routing.md","docs/agents/coding-skill-routing.md","docs/agents/confidence-rubric.md","docs/agents/contract-test-ledger.md","docs/agents/implementation-review-loop.md","docs/agents/review-gates.md","docs/agents/review-protocol.md","docs/agents/tool-usage.md","skills/implementation-spec-review/SKILL.md","skills/implementation-spec-review/agents/openai.yaml"],"metadata":"skills/implementation-spec-review/agents/openai.yaml"},"research":{"entry":"skills/research/SKILL.md","files":["docs/agents/artifact-review-loop.md","docs/agents/bug-workflow-routing.md","docs/agents/coding-skill-routing.md","docs/agents/confidence-rubric.md","docs/agents/contract-test-ledger.md","docs/agents/implementation-review-loop.md","docs/agents/review-gates.md","docs/agents/review-protocol.md","docs/agents/tool-usage.md","skills/research/SKILL.md","skills/research/agents/openai.yaml"],"metadata":"skills/research/agents/openai.yaml"},"small-task-implementer":{"entry":"skills/small-task-implementer/SKILL.md","files":["docs/agents/artifact-review-loop.md","docs/agents/bug-workflow-routing.md","docs/agents/coding-skill-routing.md","docs/agents/confidence-rubric.md","docs/agents/contract-test-ledger.md","docs/agents/implementation-review-loop.md","docs/agents/review-gates.md","docs/agents/review-protocol.md","docs/agents/tool-usage.md","skills/small-task-implementer/SKILL.md","skills/small-task-implementer/agents/openai.yaml"],"metadata":"skills/small-task-implementer/agents/openai.yaml"},"spec-implementer":{"entry":"skills/spec-implementer/SKILL.md","files":["docs/agents/artifact-review-loop.md","docs/agents/bug-workflow-routing.md","docs/agents/coding-skill-routing.md","docs/agents/confidence-rubric.md","docs/agents/contract-test-ledger.md","docs/agents/implementation-review-loop.md","docs/agents/review-gates.md","docs/agents/review-protocol.md","docs/agents/tool-usage.md","skills/spec-implementer/SKILL.md","skills/spec-implementer/agents/openai.yaml"],"metadata":"skills/spec-implementer/agents/openai.yaml"},"tdd":{"entry":"skills/tdd/SKILL.md","files":["docs/agents/artifact-review-loop.md","docs/agents/bug-workflow-routing.md","docs/agents/coding-skill-routing.md","docs/agents/confidence-rubric.md","docs/agents/contract-test-ledger.md","docs/agents/implementation-review-loop.md","docs/agents/review-gates.md","docs/agents/review-protocol.md","docs/agents/tool-usage.md","skills/tdd/SKILL.md","skills/tdd/agents/openai.yaml","skills/tdd/interface-design.md","skills/tdd/mocking.md","skills/tdd/refactoring.md","skills/tdd/tests.md"],"metadata":"skills/tdd/agents/openai.yaml"},"triage":{"entry":"skills/triage/SKILL.md","files":["docs/agents/artifact-review-loop.md","docs/agents/bug-workflow-routing.md","docs/agents/coding-skill-routing.md","docs/agents/confidence-rubric.md","docs/agents/contract-test-ledger.md","docs/agents/implementation-review-loop.md","docs/agents/review-gates.md","docs/agents/review-protocol.md","docs/agents/tool-usage.md","skills/triage/AGENT-BRIEF.md","skills/triage/OUT-OF-SCOPE.md","skills/triage/SKILL.md","skills/triage/agents/openai.yaml"],"metadata":"skills/triage/agents/openai.yaml"},"ui-evidence-proof":{"entry":"skills/ui-evidence-proof/SKILL.md","files":["docs/agents/artifact-review-loop.md","docs/agents/bug-workflow-routing.md","docs/agents/coding-skill-routing.md","docs/agents/confidence-rubric.md","docs/agents/contract-test-ledger.md","docs/agents/implementation-review-loop.md","docs/agents/review-gates.md","docs/agents/review-protocol.md","docs/agents/tool-usage.md","skills/ui-evidence-proof/SKILL.md","skills/ui-evidence-proof/agents/openai.yaml"],"metadata":"skills/ui-evidence-proof/agents/openai.yaml"}},"sourceFingerprint":"c7192bf50b93417bc56ab78cb07fc5a5d3b56f80c5b0dce5c55f01944d2a1fd6","version":1}

package/internal-workflow/operations/acceptance-proof/SKILL.md

@@ -0,0 +1,3 @@
+# Acceptance Proof Operation
+
+Follow `skills/acceptance-proof/SKILL.md`. Never change product behavior or external state. Return only `schemas/proof-report-v1.json`.

package/internal-workflow/operations/ambiguity-review/SKILL.md

@@ -0,0 +1,3 @@
+# Fresh Ambiguity Review Operation
+
+Independently verify that a supplied waiting candidate contains at least two materially different product outcomes and no source-authorized choice. Technical, architecture, test, and tool choices are never product ambiguity. Do not edit files or external state. Return only `schemas/ambiguity-review-v1.json`.

package/internal-workflow/operations/cleanup-review/SKILL.md

@@ -0,0 +1,3 @@
+# Cleanup Review Operation
+
+Follow `skills/cleanup-review/SKILL.md`. Review only; do not edit files or external state. Return only `schemas/code-review-v1.json`.

package/internal-workflow/operations/code-review/SKILL.md

@@ -0,0 +1,3 @@
+# Code Review Operation
+
+Follow `skills/code-review/SKILL.md`. Review only; do not edit files or external state. Return only `schemas/code-review-v1.json`.

package/internal-workflow/operations/implementation/SKILL.md

@@ -0,0 +1,3 @@
+# Implementation Operation
+
+Follow `skills/agent-auto/SKILL.md`. Never commit, push, publish, or mutate GitHub. Return only `schemas/implementation-report-v1.json`.

package/internal-workflow/operations/spec-author/SKILL.md

@@ -0,0 +1,3 @@
+# Spec Author Operation
+
+Follow `skills/implementation-spec-maker/SKILL.md` for the supplied issue authority. Write only the Runner-provided spec artifact location and return `schemas/spec-author-v1.json`.

package/internal-workflow/operations/spec-implementation/SKILL.md

@@ -0,0 +1,3 @@
+# Spec Implementation Operation
+
+Follow `skills/spec-implementer/SKILL.md` and the exact frozen spec. Never commit, publish, or mutate GitHub. Return only `schemas/implementation-report-v1.json`.

package/internal-workflow/operations/spec-review/SKILL.md

@@ -0,0 +1,3 @@
+# Spec Review Operation
+
+Follow `skills/implementation-spec-review/SKILL.md`. Do not edit the spec or external state. Return only `schemas/spec-review-v1.json`.

package/internal-workflow/operations/triage/SKILL.md

@@ -0,0 +1,3 @@
+# Triage Operation
+
+Follow `skills/triage/SKILL.md`. Inspect the supplied issue and repository evidence without edits or external writes. Return only `schemas/triage-route-v1.json`.

package/internal-workflow/profiles/analyst_deep.toml

@@ -0,0 +1,9 @@
+name = "analyst_deep"
+description = "Deep read-only analysis for ambiguous architecture, contracts, and root causes."
+nickname_candidates = ["Sage"]
+model = "gpt-5.6-sol"
+model_reasoning_effort = "xhigh"
+sandbox_mode = "read-only"
+developer_instructions = """
+Analyze only. Build evidence-backed conclusions and recommendations; leave final decisions and edits to the parent.
+"""

package/internal-workflow/profiles/implementer_deep.toml

@@ -0,0 +1,9 @@
+name = "implementer_deep"
+description = "Write-capable implementation worker for an isolated approved slice with material technical uncertainty."
+nickname_candidates = ["Foundry", "Helix", "Vector"]
+model = "gpt-5.6-sol"
+model_reasoning_effort = "high"
+sandbox_mode = "workspace-write"
+developer_instructions = """
+Implement only the assigned isolated high-complexity ticket slice. Resolve technical uncertainty from repository evidence without changing approved product behavior, ownership, or slice boundaries. Respect exclusive write scope and stop on overlap or decision drift. You are not alone in the repository: preserve unrelated and concurrent changes and never revert work you do not own. Use behavior-first proof and return changed files, acceptance proof, skipped checks, risks, decision deltas, and blockers to the root integrator.
+"""

package/internal-workflow/profiles/implementer_standard.toml

@@ -0,0 +1,9 @@
+name = "implementer_standard"
+description = "Write-capable implementation worker for one approved, bounded ticket slice."
+nickname_candidates = ["Forge", "Mason", "Builder"]
+model = "gpt-5.6-sol"
+model_reasoning_effort = "medium"
+sandbox_mode = "workspace-write"
+developer_instructions = """
+Implement only the assigned approved ticket slice through its observable interface. Respect the exact write scope, tests, exclusions, and stop conditions. You are not alone in the repository: preserve unrelated and concurrent changes, never revert work you do not own, and report overlap before editing. Use behavior-first proof for behavior changes and return changed files, acceptance proof, skipped checks, risks, and blockers to the root integrator.
+"""

package/internal-workflow/profiles/proof_agent.toml

@@ -0,0 +1,8 @@
+name = "proof_agent"
+description = "Write-capable contained proof worker; Runner enforces proof-only postconditions."
+model = "gpt-5.6-sol"
+model_reasoning_effort = "high"
+sandbox_mode = "workspace-write"
+developer_instructions = """
+Prove only the frozen criteria. Write only proof evidence requested by the Runner, never product behavior, Git history, GitHub state, publication state, or credentials. Return the exact supplied JSON schema.
+"""

package/internal-workflow/profiles/researcher_standard.toml

@@ -0,0 +1,9 @@
+name = "researcher_standard"
+description = "Read-only external research against primary sources with claim-level citations."
+nickname_candidates = ["Atlas", "Index", "Scribe"]
+model = "gpt-5.6-sol"
+model_reasoning_effort = "medium"
+sandbox_mode = "read-only"
+developer_instructions = """
+Research one bounded external question from the supplied Research Capsule. Prefer official documentation, specifications, first-party source code, changelogs, release notes, issue trackers, APIs, and schemas. Map every material claim to the exact primary source and include source version/date when available. Separate sourced facts from repository inference; expose conflicts, stale evidence, uncertainty, and missing proof. Never edit files, create artifacts, change code, or broaden into unrelated reading. Return a concise short answer, claim-to-source ledger, decision implications, and unresolved questions to the root integrator.
+"""

package/internal-workflow/profiles/reviewer_deep.toml

@@ -0,0 +1,9 @@
+name = "reviewer_deep"
+description = "Independent read-only reviewer for plans, specs, code, cleanup, and security."
+nickname_candidates = ["Atlas", "Delta", "Echo"]
+model = "gpt-5.6-sol"
+model_reasoning_effort = "high"
+sandbox_mode = "read-only"
+developer_instructions = """
+Review adversarially and exhaustively. Trace contracts, authorization, failure recovery, concurrency, and state transitions. For code, inspect every external side effect and verify asynchronous work is awaited or returned. Never edit files; return proposed fixes to the parent. Report only concrete findings with evidence, severity, confidence, and verification gaps.
+"""

package/internal-workflow/profiles/reviewer_fast.toml

@@ -0,0 +1,9 @@
+name = "reviewer_fast"
+description = "Fast independent read-only reviewer for simple plans, specs, tickets, cleanup, and code changes."
+nickname_candidates = ["Dash", "Jet", "Swift"]
+model = "gpt-5.6-terra"
+model_reasoning_effort = "medium"
+sandbox_mode = "read-only"
+developer_instructions = """
+Review independently and proportionately. Prioritize concrete correctness, scope, contract, and verification gaps; avoid speculative edge cases and cosmetic comments. Never edit files. Return concise findings with evidence, severity, confidence, and proposed fixes to the parent.
+"""

package/internal-workflow/profiles/reviewer_standard.toml

@@ -0,0 +1,9 @@
+name = "reviewer_standard"
+description = "Independent read-only reviewer for medium-risk plans, specs, tickets, cleanup, and code changes."
+nickname_candidates = ["Aster", "Quill", "Vega"]
+model = "gpt-5.6-sol"
+model_reasoning_effort = "medium"
+sandbox_mode = "read-only"
+developer_instructions = """
+Review independently and proportionately. Trace the changed behavior, ownership, contracts, failure paths, and validation without expanding scope. Never edit files. Return concrete findings with evidence, severity, confidence, verification gaps, and proposed fixes to the parent.
+"""

package/internal-workflow/schemas/ambiguity-review-v1.json

@@ -0,0 +1 @@
+{"additionalProperties":false,"properties":{"candidateSha256":{"pattern":"^[a-f0-9]{64}$","type":"string"},"evidenceReviewed":{"items":{"minLength":1,"type":"string"},"type":"array"},"findings":{"items":{"minLength":1,"type":"string"},"type":"array"},"recommendation":{"minLength":1,"type":"string"},"verdict":{"enum":["approved","rejected","blocked"],"type":"string"},"version":{"const":1,"type":"integer"}},"required":["version","candidateSha256","verdict","evidenceReviewed","findings","recommendation"],"type":"object"}

package/internal-workflow/schemas/code-review-v1.json

@@ -0,0 +1 @@
+{"type":"object","additionalProperties":false,"required":["report"],"properties":{"report":{"type":"object","additionalProperties":false,"required":["version","operation","targetRevision","targetFingerprint","verdict","mode","coverage","defects","residualRisks","reviewerSessionId","closureRequestSha256","repairFindingOutcomes"],"properties":{"version":{"type":"integer","const":1},"operation":{"type":"string","enum":["cleanup-review","code-review"]},"targetRevision":{"type":"integer","minimum":1},"targetFingerprint":{"type":"string","pattern":"^[0-9a-f]{64}$"},"verdict":{"type":"string","enum":["approved","needs-work","rejected"]},"mode":{"type":"string","enum":["full","closure"]},"coverage":{"type":"array","maxItems":256,"items":{"type":"string","minLength":1,"maxLength":16384}},"defects":{"type":"array","maxItems":256,"items":{"type":"object","additionalProperties":false,"required":["id","class","severity","confidence","status","invariant","failure","evidence","repair","affectedTargets","introducedTargetRevision","statusTargetRevision","supersededBy"],"properties":{"id":{"type":"string","minLength":1,"maxLength":16384},"class":{"type":"string","enum":["blocker","execution-risk","improvement"]},"severity":{"type":"string","enum":["critical","high","medium","low"]},"confidence":{"type":"string","enum":["high","medium","low"]},"status":{"type":"string","enum":["open","fixed","verified","reopened","superseded"]},"invariant":{"type":"string","minLength":1,"maxLength":16384},"failure":{"type":"string","minLength":1,"maxLength":16384},"evidence":{"type":"array","maxItems":256,"items":{"type":"string","minLength":1,"maxLength":16384}},"repair":{"type":"string","minLength":1,"maxLength":16384},"affectedTargets":{"type":"array","maxItems":256,"items":{"type":"string","minLength":1,"maxLength":16384}},"introducedTargetRevision":{"type":"integer","minimum":1},"statusTargetRevision":{"type":"integer","minimum":1},"supersededBy":{"anyOf":[{"type":"string","minLength":1,"maxLength":16384},{"type":"null"}]}}}},"residualRisks":{"type":"array","maxItems":256,"items":{"type":"string","minLength":1,"maxLength":16384}},"reviewerSessionId":{"type":"string","minLength":1,"maxLength":16384},"closureRequestSha256":{"anyOf":[{"type":"string","pattern":"^[0-9a-f]{64}$"},{"type":"null"}]},"repairFindingOutcomes":{"type":"array","maxItems":256,"items":{"type":"object","additionalProperties":false,"required":["id","status"],"properties":{"id":{"type":"string","minLength":1,"maxLength":16384},"status":{"type":"string","enum":["verified","reopened"]}}}}}}}}

package/internal-workflow/schemas/implementation-report-v1.json

@@ -0,0 +1 @@
+{"type":"object","additionalProperties":false,"required":["report"],"properties":{"report":{"anyOf":[{"type":"object","additionalProperties":false,"required":["version","status","summary","changedFiles","residualRisks"],"properties":{"version":{"type":"integer","const":1},"summary":{"type":"string","minLength":1,"maxLength":4096},"changedFiles":{"type":"array","maxItems":256,"items":{"type":"string","minLength":1,"maxLength":16384,"pattern":"^[^/\\\\]$|^[^/\\\\][^\\\\]*[^/\\\\]$"},"minItems":1},"residualRisks":{"type":"array","maxItems":256,"items":{"type":"string","minLength":1,"maxLength":16384}},"status":{"type":"string","const":"completed"}}},{"type":"object","additionalProperties":false,"required":["version","status","summary","changedFiles","residualRisks","blocker"],"properties":{"version":{"type":"integer","const":1},"summary":{"type":"string","minLength":1,"maxLength":4096},"changedFiles":{"type":"array","maxItems":256,"items":{"type":"string","minLength":1,"maxLength":16384,"pattern":"^[^/\\\\]$|^[^/\\\\][^\\\\]*[^/\\\\]$"}},"residualRisks":{"type":"array","maxItems":256,"items":{"type":"string","minLength":1,"maxLength":16384}},"status":{"type":"string","const":"external-block"},"blocker":{"type":"object","additionalProperties":false,"required":["kind","summary","attempted"],"properties":{"kind":{"type":"string","enum":["credential","tool","service","product-decision"]},"summary":{"type":"string","minLength":1,"maxLength":4096},"attempted":{"type":"array","maxItems":256,"items":{"type":"string","minLength":1,"maxLength":16384}}}}}}]}}}

package/internal-workflow/schemas/proof-report-v1.json

@@ -0,0 +1 @@
+{"type":"object","additionalProperties":false,"required":["report"],"properties":{"report":{"type":"object","additionalProperties":false,"required":["version","status","decision","criteria","checks","artifacts","visualEvidence","findings","residualRisks","blocker"],"properties":{"version":{"type":"integer","const":1},"status":{"type":"string","enum":["passed","needs-rework","external-block"]},"decision":{"anyOf":[{"type":"object","additionalProperties":false,"required":["mode","targets"],"properties":{"mode":{"type":"string","const":"non-visual"},"targets":{"type":"array","maxItems":0,"items":{"type":"string","enum":["browser","android","ios"]}}}},{"type":"object","additionalProperties":false,"required":["mode","targets"],"properties":{"mode":{"type":"string","const":"visual"},"targets":{"type":"array","minItems":1,"maxItems":3,"items":{"type":"string","enum":["browser","android","ios"]}}}}]},"criteria":{"type":"array","minItems":1,"maxItems":256,"items":{"type":"object","additionalProperties":false,"required":["id","status","confidence","surfaces","evidenceRefs","analysis"],"properties":{"id":{"type":"string","minLength":1,"maxLength":16384},"status":{"type":"string","enum":["passed","failed","unknown"]},"confidence":{"type":"string","enum":["high","medium","low"]},"surfaces":{"type":"array","minItems":1,"maxItems":4,"items":{"type":"string","enum":["non-visual","browser","android","ios"]}},"evidenceRefs":{"type":"array","minItems":0,"maxItems":256,"items":{"type":"string","minLength":1,"maxLength":16384}},"analysis":{"type":"string","minLength":1,"maxLength":4096}}}},"checks":{"type":"array","maxItems":256,"items":{"type":"object","additionalProperties":false,"required":["id","command","status","summary","outputSha256"],"properties":{"id":{"type":"string","minLength":1,"maxLength":16384},"command":{"type":"string","minLength":1,"maxLength":16384},"status":{"type":"string","enum":["passed","failed"]},"summary":{"type":"string","minLength":1,"maxLength":4096},"outputSha256":{"type":"string","pattern":"^[0-9a-f]{64}$"}}}},"artifacts":{"type":"array","maxItems":256,"items":{"type":"object","additionalProperties":false,"required":["id","kind","relativePath","sha256","publishable","description"],"properties":{"id":{"type":"string","minLength":1,"maxLength":16384},"kind":{"type":"string","enum":["command-output","static-inspection","generated-file","screenshot","dom-snapshot","console-log","network-log","ui-hierarchy","device-log","lease-record"]},"relativePath":{"type":"string","minLength":1,"maxLength":16384,"pattern":"^[^/\\\\]$|^[^/\\\\][^\\\\]*[^/\\\\]$"},"sha256":{"type":"string","pattern":"^[0-9a-f]{64}$"},"publishable":{"type":"boolean"},"description":{"type":"string","minLength":1,"maxLength":4096}}}},"visualEvidence":{"anyOf":[{"type":"object","additionalProperties":false,"required":["workflow","captures","diagnostics","freshness","layoutReview","copyReview"],"properties":{"workflow":{"type":"object","additionalProperties":false,"required":["entrypoint","steps","finalState"],"properties":{"entrypoint":{"type":"string","minLength":1,"maxLength":16384},"steps":{"type":"array","minItems":1,"maxItems":256,"items":{"type":"string","minLength":1,"maxLength":16384}},"finalState":{"type":"string","minLength":1,"maxLength":4096}}},"captures":{"type":"array","minItems":2,"maxItems":256,"items":{"type":"object","additionalProperties":false,"required":["target","name","width","height","criteriaRefs","screenshotRef","stateRef"],"properties":{"target":{"type":"string","const":"browser"},"name":{"type":"string","minLength":1,"maxLength":16384},"width":{"type":"integer"},"height":{"type":"integer"},"criteriaRefs":{"type":"array","minItems":1,"maxItems":256,"items":{"type":"string","minLength":1,"maxLength":16384}},"screenshotRef":{"type":"string","minLength":1,"maxLength":16384},"stateRef":{"type":"string","minLength":1,"maxLength":16384}}}},"diagnostics":{"type":"object","additionalProperties":false,"required":["consoleRef","networkRef"],"properties":{"consoleRef":{"type":"string","minLength":1,"maxLength":16384},"networkRef":{"type":"string","minLength":1,"maxLength":16384}}},"freshness":{"type":"object","additionalProperties":false,"required":["capturedAfterFinalInteraction"],"properties":{"capturedAfterFinalInteraction":{"type":"boolean","const":true}}},"layoutReview":{"type":"array","minItems":1,"maxItems":256,"items":{"type":"object","additionalProperties":false,"required":["summary","evidenceRefs"],"properties":{"summary":{"type":"string","minLength":1,"maxLength":4096},"evidenceRefs":{"type":"array","minItems":1,"maxItems":256,"items":{"type":"string","minLength":1,"maxLength":16384}}}}},"copyReview":{"type":"array","minItems":1,"maxItems":256,"items":{"type":"object","additionalProperties":false,"required":["summary","evidenceRefs"],"properties":{"summary":{"type":"string","minLength":1,"maxLength":4096},"evidenceRefs":{"type":"array","minItems":1,"maxItems":256,"items":{"type":"string","minLength":1,"maxLength":16384}}}}}}},{"type":"object","additionalProperties":false,"required":["workflow","captures","diagnostics","lease","freshness","layoutReview","copyReview"],"properties":{"workflow":{"type":"object","additionalProperties":false,"required":["entrypoint","steps","finalState"],"properties":{"entrypoint":{"type":"string","minLength":1,"maxLength":16384},"steps":{"type":"array","minItems":1,"maxItems":256,"items":{"type":"string","minLength":1,"maxLength":16384}},"finalState":{"type":"string","minLength":1,"maxLength":4096}}},"captures":{"type":"array","minItems":1,"maxItems":256,"items":{"type":"object","additionalProperties":false,"required":["target","name","width","height","criteriaRefs","screenshotRef","stateRef"],"properties":{"target":{"type":"string","const":"android"},"name":{"type":"string","minLength":1,"maxLength":16384},"width":{"type":"integer"},"height":{"type":"integer"},"criteriaRefs":{"type":"array","minItems":1,"maxItems":256,"items":{"type":"string","minLength":1,"maxLength":16384}},"screenshotRef":{"type":"string","minLength":1,"maxLength":16384},"stateRef":{"type":"string","minLength":1,"maxLength":16384}}}},"diagnostics":{"type":"object","additionalProperties":false,"required":["deviceLogRef"],"properties":{"deviceLogRef":{"type":"string","minLength":1,"maxLength":16384}}},"lease":{"type":"object","additionalProperties":false,"required":["leaseRef"],"properties":{"leaseRef":{"type":"string","minLength":1,"maxLength":16384}}},"freshness":{"type":"object","additionalProperties":false,"required":["capturedAfterFinalInteraction"],"properties":{"capturedAfterFinalInteraction":{"type":"boolean","const":true}}},"layoutReview":{"type":"array","minItems":1,"maxItems":256,"items":{"type":"object","additionalProperties":false,"required":["summary","evidenceRefs"],"properties":{"summary":{"type":"string","minLength":1,"maxLength":4096},"evidenceRefs":{"type":"array","minItems":1,"maxItems":256,"items":{"type":"string","minLength":1,"maxLength":16384}}}}},"copyReview":{"type":"array","minItems":1,"maxItems":256,"items":{"type":"object","additionalProperties":false,"required":["summary","evidenceRefs"],"properties":{"summary":{"type":"string","minLength":1,"maxLength":4096},"evidenceRefs":{"type":"array","minItems":1,"maxItems":256,"items":{"type":"string","minLength":1,"maxLength":16384}}}}}}},{"type":"object","additionalProperties":false,"required":["workflow","captures","diagnostics","lease","freshness","layoutReview","copyReview"],"properties":{"workflow":{"type":"object","additionalProperties":false,"required":["entrypoint","steps","finalState"],"properties":{"entrypoint":{"type":"string","minLength":1,"maxLength":16384},"steps":{"type":"array","minItems":1,"maxItems":256,"items":{"type":"string","minLength":1,"maxLength":16384}},"finalState":{"type":"string","minLength":1,"maxLength":4096}}},"captures":{"type":"array","minItems":1,"maxItems":256,"items":{"type":"object","additionalProperties":false,"required":["target","name","width","height","criteriaRefs","screenshotRef","stateRef"],"properties":{"target":{"type":"string","const":"ios"},"name":{"type":"string","minLength":1,"maxLength":16384},"width":{"type":"integer"},"height":{"type":"integer"},"criteriaRefs":{"type":"array","minItems":1,"maxItems":256,"items":{"type":"string","minLength":1,"maxLength":16384}},"screenshotRef":{"type":"string","minLength":1,"maxLength":16384},"stateRef":{"type":"string","minLength":1,"maxLength":16384}}}},"diagnostics":{"type":"object","additionalProperties":false,"required":["deviceLogRef"],"properties":{"deviceLogRef":{"type":"string","minLength":1,"maxLength":16384}}},"lease":{"type":"object","additionalProperties":false,"required":["leaseRef"],"properties":{"leaseRef":{"type":"string","minLength":1,"maxLength":16384}}},"freshness":{"type":"object","additionalProperties":false,"required":["capturedAfterFinalInteraction"],"properties":{"capturedAfterFinalInteraction":{"type":"boolean","const":true}}},"layoutReview":{"type":"array","minItems":1,"maxItems":256,"items":{"type":"object","additionalProperties":false,"required":["summary","evidenceRefs"],"properties":{"summary":{"type":"string","minLength":1,"maxLength":4096},"evidenceRefs":{"type":"array","minItems":1,"maxItems":256,"items":{"type":"string","minLength":1,"maxLength":16384}}}}},"copyReview":{"type":"array","minItems":1,"maxItems":256,"items":{"type":"object","additionalProperties":false,"required":["summary","evidenceRefs"],"properties":{"summary":{"type":"string","minLength":1,"maxLength":4096},"evidenceRefs":{"type":"array","minItems":1,"maxItems":256,"items":{"type":"string","minLength":1,"maxLength":16384}}}}}}},{"type":"null"}]},"findings":{"type":"array","maxItems":256,"items":{"type":"string","minLength":1,"maxLength":16384}},"residualRisks":{"type":"array","maxItems":256,"items":{"type":"string","minLength":1,"maxLength":16384}},"blocker":{"anyOf":[{"type":"object","additionalProperties":false,"required":["kind","summary","attempted"],"properties":{"kind":{"type":"string","enum":["credential","tool","service","product-decision"]},"summary":{"type":"string","minLength":1,"maxLength":4096},"attempted":{"type":"array","maxItems":256,"items":{"type":"string","minLength":1,"maxLength":16384}}}},{"type":"null"}]}}}}}

package/internal-workflow/schemas/spec-author-v1.json

@@ -0,0 +1 @@
+{"additionalProperties":false,"properties":{"blockers":{"items":{"minLength":1,"type":"string"},"type":"array"},"specPath":{"type":["string","null"]},"specSha256":{"type":["string","null"]},"status":{"enum":["ready","blocked"],"type":"string"},"summary":{"minLength":1,"type":"string"},"version":{"const":1,"type":"integer"}},"required":["version","status","specPath","specSha256","summary","blockers"],"type":"object"}

package/internal-workflow/schemas/spec-review-v1.json

@@ -0,0 +1,30 @@
+{
+  "additionalProperties": false,
+  "properties": {
+    "acceptedRisks": {
+      "items": {
+        "additionalProperties": false,
+        "properties": {
+          "acceptedBy": { "minLength": 1, "type": "string" },
+          "defectId": { "minLength": 1, "type": "string" },
+          "policy": { "minLength": 1, "type": "string" },
+          "rationale": { "minLength": 1, "type": "string" }
+        },
+        "required": ["defectId", "rationale", "policy", "acceptedBy"],
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "affectedContracts": { "items": { "minLength": 1, "type": "string" }, "type": "array" },
+    "affectedDefectIds": { "items": { "minLength": 1, "type": "string" }, "type": "array" },
+    "coverage": { "items": { "minLength": 1, "type": "string" }, "type": "array" },
+    "coverageInvalidated": { "type": "boolean" },
+    "defects": { "items": { "type": "object" }, "type": "array" },
+    "mode": { "enum": ["full", "closure"], "type": "string" },
+    "reviewerSessionId": { "minLength": 1, "type": "string" },
+    "verdict": { "enum": ["approved", "needs-work", "rejected"], "type": "string" },
+    "version": { "const": 1, "type": "integer" }
+  },
+  "required": ["version", "verdict", "mode", "coverage", "defects", "reviewerSessionId", "affectedDefectIds", "affectedContracts", "coverageInvalidated", "acceptedRisks"],
+  "type": "object"
+}

package/internal-workflow/schemas/triage-route-v1.json

@@ -0,0 +1 @@
+{"type":"object","additionalProperties":false,"required":["report"],"properties":{"report":{"anyOf":[{"type":"object","additionalProperties":false,"required":["version","status","inspectedEvidence","assumptions","direct","specRequired","awaitingUser","blocker"],"properties":{"version":{"type":"integer","const":1},"status":{"type":"string","const":"direct"},"inspectedEvidence":{"type":"array","minItems":1,"maxItems":256,"items":{"type":"object","additionalProperties":false,"required":["kind","location","summary"],"properties":{"kind":{"type":"string","enum":["issue","comment","code","caller","test","instruction","context","domain","adr","behavior"]},"location":{"type":"string","minLength":1,"maxLength":16384},"summary":{"type":"string","minLength":1,"maxLength":16384}}}},"assumptions":{"type":"array","minItems":0,"maxItems":256,"items":{"type":"string","minLength":1,"maxLength":16384}},"direct":{"type":"object","additionalProperties":false,"required":["summary","behaviors","verification"],"properties":{"summary":{"type":"string","minLength":1,"maxLength":16384},"behaviors":{"type":"array","minItems":1,"maxItems":256,"items":{"type":"string","minLength":1,"maxLength":16384}},"verification":{"type":"array","minItems":1,"maxItems":256,"items":{"type":"string","minLength":1,"maxLength":16384}}}},"specRequired":{"type":"null"},"awaitingUser":{"type":"null"},"blocker":{"type":"null"}}},{"type":"object","additionalProperties":false,"required":["version","status","inspectedEvidence","assumptions","direct","specRequired","awaitingUser","blocker"],"properties":{"version":{"type":"integer","const":1},"status":{"type":"string","const":"spec-required"},"inspectedEvidence":{"type":"array","minItems":1,"maxItems":256,"items":{"type":"object","additionalProperties":false,"required":["kind","location","summary"],"properties":{"kind":{"type":"string","enum":["issue","comment","code","caller","test","instruction","context","domain","adr","behavior"]},"location":{"type":"string","minLength":1,"maxLength":16384},"summary":{"type":"string","minLength":1,"maxLength":16384}}}},"assumptions":{"type":"array","minItems":0,"maxItems":256,"items":{"type":"string","minLength":1,"maxLength":16384}},"direct":{"type":"null"},"specRequired":{"type":"object","additionalProperties":false,"required":["summary","complexityReasons","specMode","reviewFocus"],"properties":{"summary":{"type":"string","minLength":1,"maxLength":16384},"complexityReasons":{"type":"array","minItems":1,"maxItems":256,"items":{"type":"string","minLength":1,"maxLength":16384}},"specMode":{"type":"string","enum":["compact","standard"]},"reviewFocus":{"type":"array","minItems":1,"maxItems":256,"items":{"type":"string","minLength":1,"maxLength":16384}}}},"awaitingUser":{"type":"null"},"blocker":{"type":"null"}}},{"type":"object","additionalProperties":false,"required":["version","status","inspectedEvidence","assumptions","direct","specRequired","awaitingUser","blocker"],"properties":{"version":{"type":"integer","const":1},"status":{"type":"string","const":"awaiting-user"},"inspectedEvidence":{"type":"array","minItems":1,"maxItems":256,"items":{"type":"object","additionalProperties":false,"required":["kind","location","summary"],"properties":{"kind":{"type":"string","enum":["issue","comment","code","caller","test","instruction","context","domain","adr","behavior"]},"location":{"type":"string","minLength":1,"maxLength":16384},"summary":{"type":"string","minLength":1,"maxLength":16384}}}},"assumptions":{"type":"array","minItems":0,"maxItems":256,"items":{"type":"string","minLength":1,"maxLength":16384}},"direct":{"type":"null"},"specRequired":{"type":"null"},"awaitingUser":{"type":"object","additionalProperties":false,"required":["outcomes","absenceOfAuthorizedChoiceEvidence","recommendation","question"],"properties":{"outcomes":{"type":"array","minItems":2,"maxItems":256,"items":{"type":"object","additionalProperties":false,"required":["id","title","behaviorDelta","evidence"],"properties":{"id":{"type":"string","minLength":1,"maxLength":16384},"title":{"type":"string","minLength":1,"maxLength":16384},"behaviorDelta":{"type":"string","minLength":1,"maxLength":16384},"evidence":{"type":"array","minItems":1,"maxItems":256,"items":{"type":"string","minLength":1,"maxLength":16384}}}}},"absenceOfAuthorizedChoiceEvidence":{"type":"array","minItems":1,"maxItems":256,"items":{"type":"string","minLength":1,"maxLength":16384}},"recommendation":{"type":"string","minLength":1,"maxLength":16384},"question":{"type":"string","minLength":1,"maxLength":16384}}},"blocker":{"type":"null"}}},{"type":"object","additionalProperties":false,"required":["version","status","inspectedEvidence","assumptions","direct","specRequired","awaitingUser","blocker"],"properties":{"version":{"type":"integer","const":1},"status":{"type":"string","const":"blocked"},"inspectedEvidence":{"type":"array","minItems":1,"maxItems":256,"items":{"type":"object","additionalProperties":false,"required":["kind","location","summary"],"properties":{"kind":{"type":"string","enum":["issue","comment","code","caller","test","instruction","context","domain","adr","behavior"]},"location":{"type":"string","minLength":1,"maxLength":16384},"summary":{"type":"string","minLength":1,"maxLength":16384}}}},"assumptions":{"type":"array","minItems":0,"maxItems":256,"items":{"type":"string","minLength":1,"maxLength":16384}},"direct":{"type":"null"},"specRequired":{"type":"null"},"awaitingUser":{"type":"null"},"blocker":{"type":"object","additionalProperties":false,"required":["kind","code","summary","evidence"],"properties":{"kind":{"type":"string","enum":["external","safety","exhausted"]},"code":{"type":"string","minLength":1,"maxLength":16384},"summary":{"type":"string","minLength":1,"maxLength":16384},"evidence":{"type":"array","minItems":1,"maxItems":256,"items":{"type":"string","minLength":1,"maxLength":16384}}}}}}]}}}

package/internal-workflow/skills/acceptance-proof/agents/openai.yaml

@@ -0,0 +1,6 @@
+interface:
+  display_name: "Acceptance Proof"
+  short_description: "Independently prove frozen acceptance criteria"
+  default_prompt: "Follow the package-owned acceptance-proof operation and return its exact JSON report."
+policy:
+  allow_implicit_invocation: false

package/internal-workflow/skills/agent-auto/agents/openai.yaml

@@ -0,0 +1,6 @@
+interface:
+  display_name: "Agent Auto Implementation"
+  short_description: "Implement one runner-owned issue attempt"
+  default_prompt: "Follow the package-owned implementation operation and return its exact JSON report."
+policy:
+  allow_implicit_invocation: false

package/internal-workflow/skills/cleanup-review/SKILL.md

@@ -0,0 +1,84 @@
+---
+name: "cleanup-review"
+description: "Run an independent post-implementation simplification review only when a concrete cleanup risk cannot fit final code review. Find removable duplication, obsolete paths, workarounds, and unjustified abstractions without re-reviewing correctness."
+---
+
+# Cleanup Review
+
+Use this skill after implementation has settled and before final `$code-review`.
+It is a cleanup-only Adapter: its job is to reduce maintenance surface without
+changing required observable behavior.
+
+Do not invoke it separately from implementation size or risk classification.
+The final `$code-review` spec/standards lens owns bounded hygiene for every
+profile, with a dedicated parallel reviewer track for `high`. Use this Adapter
+only when the user, approved source, or repo policy names a concrete evidenced
+cleanup risk that cannot be covered proportionately by that lens.
+
+When an Implementation Review Module schedules this Adapter, follow
+`../../docs/agents/implementation-review-loop.md` for topology, state, defect
+lifecycle, and Closure. Otherwise follow
+`../../docs/agents/review-gates.md`. This skill does not create its own loop.
+
+## Invocation Contract
+
+- Use one profile-selected independent reviewer. Root never reviews or certifies cleanup inline.
+- One logical activation spans the Full pass and every lineage-preserving Closure; protocol session rotation creates neither a new activation nor Full pass.
+- Run one Full cleanup review only after the complete implementation diff and required validation have settled. Never run it per slice or re-enter cleanup after final code review starts.
+- The implementation owner integrates accepted fixes. The reviewer remains read-only and returns evidence and bounded changes.
+- If independent review is unavailable, report the gate as unavailable; do not substitute root self-review.
+
+## In Scope
+
+- duplicated logic, sources of truth, registrations, or old/new paths kept in parallel
+- dead helpers, flags, adapters, branches, comments, tests, or documentation left by the change
+- workaround-shaped conditionals, magic ordering, symptom patches, and unnecessary state
+- compatibility or fallback behavior without current repository, source-authority, or production evidence
+- new services, events/listeners, adapters, or indirection with one current consumer and only speculative reuse
+- ownership placement only when moving or deleting code restores an existing owner without redesigning the system
+- stale or duplicated tests/docs only when their cleanup debt is itself the finding
+
+## Out Of Scope
+
+- functional correctness, acceptance completeness, security, privacy, performance, or product decisions
+- missing regression coverage or weak behavior proof by itself; route it to the scheduled code-review/test-quality lens
+- broad architecture redesign, future extensibility, or a request for a new abstraction unrelated to removing current duplication
+- discovery of new sibling edge cases in unchanged behavior
+- style, naming, or formatting preferences without concrete maintenance cost
+
+## Review Method
+
+1. Pin the target revision/diff and source authority supplied by the Review Plan or root.
+2. Inventory material additions, replacements, compatibility paths, and new runtime owners.
+3. Classify each material complexity decision:
+   - `KEEP`: required by a current invariant and supported by evidence or a boundary proof.
+   - `SIMPLIFY`: required behavior can use a smaller existing seam or fewer states/branches.
+   - `REMOVE`: no current behavior, authority, consumer, or compatibility evidence requires it.
+4. Report a finding only when it names exact evidence, concrete maintenance cost, and a behavior-preserving simplification. Uncertain removal becomes follow-up, not a guessed blocker.
+
+A one-producer/one-consumer abstraction defaults to `SIMPLIFY` unless a concrete
+lifecycle, transaction, dependency-direction, or fanout invariant requires the
+boundary. Do not request a new abstraction unless it reduces current duplication
+or restores an existing owner now.
+
+For Module-scheduled Closure, inspect only accepted cleanup repairs and their
+causal fan-out. Do not restart broad discovery or convert proof-only gaps into
+cleanup defects.
+
+In Module mode, reuse supplied stable cleanup IDs and return each as `verified`
+or `reopened`. Hand settled decisions/IDs to final code review; that reviewer
+rechecks hygiene only for a concrete regression caused by its own repair.
+
+## Output
+
+Return exactly:
+
+1. `Verdict: Clean | Cleanup Needed | Cleanup Blocked`
+2. `Final Coverage: cleanup-only`
+3. `Decisions`: concise `KEEP | SIMPLIFY | REMOVE` records for material complexity, each with evidence and protected invariant or maintenance cost
+4. `Findings`: actionable cleanup defects with supplied ID/lifecycle update, exact path/line evidence, and a behavior-preserving fix; otherwise `None`
+5. `Follow-up Needed`: only risky removals or missing authority/evidence; otherwise `None`
+
+`Cleanup Blocked` means the cleanup decision requires unavailable evidence or an
+explicit product/ownership choice. It never means that correctness or test-quality
+review should be performed inside this skill. Keep the result short and auditable.

package/internal-workflow/skills/cleanup-review/agents/openai.yaml

@@ -0,0 +1,6 @@
+interface:
+  display_name: "Cleanup Review"
+  short_description: "Exceptional independent simplification review"
+  default_prompt: "Use $cleanup-review only when an explicit concrete cleanup risk cannot fit the final code-review standards lens."
+policy:
+  allow_implicit_invocation: true