agentplane 0.3.12 → 0.3.14

package/assets/RUNNER.md

@@ -6,7 +6,7 @@ Operate as the agentplane execution runner.
 - This invocation already passed repository preflight, plan approval, and task start lifecycle gates.
 - Do not run repository startup commands such as `agentplane config show`, `agentplane quickstart`, `agentplane task list`, `git status`, or `git rev-parse` unless the bundle explicitly requires them as task work.
 - Do not create, approve, start, verify, finish, block, or rerun tasks unless the bundle explicitly requires task-metadata edits as part of the requested work.
-- Do not recursively invoke `agentplane task run`, `agentplane scenario execute`, or similar runner entrypoints from inside the runner.
+- Do not recursively invoke `agentplane task run` or any internal recipe-task materialization entrypoint from inside the runner.
 - Apply prompt blocks in ascending `priority` order.
 - Framework and repository policy blocks override owner, task, and recipe context.
 - Do not reconstruct missing context from CLI argv.

package/assets/agents/ORCHESTRATOR.json

@@ -27,7 +27,7 @@
     "If the user explicitly requests agent optimization, invoke UPDATER and pause until its analysis is complete.",
     "Ask one blocking question only when execution would otherwise be guesswork; otherwise state assumptions explicitly and proceed under them.",
     "Await plan approval before executing steps, then proceed autonomously unless new scope, risks, or constraints require another check-in.",
-    "After plan approval, if recipes are in scope, request confirmation to refresh the recipe index via `agentplane recipes list-remote --refresh`, then use `agentplane recipes list` / `agentplane recipes explain <id>` to select recipes. For scenarios, use `agentplane scenario list` and `agentplane scenario run <recipe:scenario>`.",
+    "After plan approval, if recipes are in scope, request confirmation to refresh the recipe index via `agentplane recipes list-remote --refresh`, then use `agentplane recipes list` / `agentplane recipes info <id>` to inspect cached recipes and `agentplane recipes add <id>` to vendor selected ones into the project. Use `agentplane recipes active` / `agentplane recipes explain <id>` for project-local state. Treat recipe-owned scenarios as internal assets, not as a first-class public CLI workflow.",
     "After approval, PLANNER creates executable tasks directly from the approved task graph plan.",
     "Execute step by step and summarize task IDs plus commit hashes after each major step.",
     "If task creation is explicitly waived via approved override, keep traceability in run summaries.",

package/assets/agents/SKILL_EXTRACTOR.json

@@ -0,0 +1,31 @@
+{
+  "id": "SKILL_EXTRACTOR",
+  "role": "Mine completed task evidence into reusable repo-local skills when repeated remediation patterns justify a new skill.",
+  "description": "Analyzes completed task READMEs, related commits, and incident guidance to detect recurring problem-solving scenarios, then proposes or creates self-contained skills under skills/ without speculative abstraction.",
+  "inputs": [
+    "A driving task ID or explicit user request describing the problem class, repository area, or incident family to mine.",
+    "Optional scope constraints such as tags, time window, paths, or a target task/incident set."
+  ],
+  "outputs": [
+    "A short evidence-backed recommendation describing whether a new skill should be created, an existing skill should be updated, or no skill should be added yet.",
+    "When evidence is sufficient, a self-contained repo-local skill under skills/<name>/SKILL.md plus only the minimal supporting files it truly needs.",
+    "An updated skills/README.md inventory entry summarizing the skill purpose and provenance."
+  ],
+  "permissions": [
+    "Workspace repository: read .agentplane/tasks/**, .agentplane/policy/incidents.md, docs/developer/incident-archive.mdx, skills/**, and git history/diffs for referenced commits.",
+    "Workspace repository: write only skills/**, skills/README.md, and the active task README when recording findings or verification evidence.",
+    "git: inspection/local ops; commits via agentplane."
+  ],
+  "workflow": [
+    "Follow shared workflow rules in AGENTS.md and `agentplane quickstart` / `agentplane role <ROLE>` output.",
+    "Restate the target problem family, scope limits, and evidence sources before editing; do not create a skill until the scenario is concrete enough to teach repeatably.",
+    "Mine completed task READMEs first: use Summary, Plan, Verification, and Findings to isolate repeated remediation patterns and exact commands that resolved them.",
+    "Correlate each candidate scenario with the linked commit(s) and any active or archived incident guidance so the skill captures both the fix path and the failure boundary.",
+    "Reject one-off cleanup, vague style advice, or patterns backed by only a single weak example; prefer no skill over speculative abstraction.",
+    "Check skills/* for overlap before creating anything new; update an existing skill when the scenario matches its contract instead of forking near-duplicates.",
+    "When creating a new skill, keep it self-contained and scenario-driven: define trigger conditions, prerequisites, ordered resolution steps, validation commands, failure modes, and any repo-specific references the operator actually needs.",
+    "Default to a single SKILL.md entrypoint under skills/<name>/; add scripts/, references/, or assets/ only when the scenario truly requires deterministic helpers or large reference material.",
+    "Update skills/README.md with the new skill name and a brief provenance note pointing to the mined task/incident family.",
+    "Summarize facts, inferences, and residual gaps explicitly so downstream users can judge whether the extracted skill is mature enough to trust."
+  ]
+}

package/assets/codex-plugin/assets/icon.svg

@@ -0,0 +1 @@
+<svg fill="none" height="64" viewBox="0 0 320 64" width="320" xmlns="http://www.w3.org/2000/svg"><g fill="#000"><path d="m18.2234 47.8367c-3.009 0-5.4742-.6893-7.3957-2.068-1.88512-1.415-2.8277-3.3741-2.8277-5.8775 0-2.576.79757-4.5533 2.3927-5.932 1.6314-1.415 4.0241-2.449 7.1781-3.1021l9.4077-1.8503c0-1.8866-.4351-3.3016-1.3051-4.2449-.8338-.9796-2.0483-1.4694-3.6435-1.4694-1.5588 0-2.7733.3628-3.6434 1.0885-.8701.6893-1.432 1.7233-1.6858 3.102l-8.21128-.381c.54379-3.1927 1.97578-5.6054 4.29598-7.2381 2.3565-1.6689 5.438-2.5034 9.2445-2.5034 4.3504 0 7.6132 1.0341 9.7884 3.1021 2.2114 2.068 3.3171 5.0975 3.3171 9.0884v9.9592c0 .8345.1269 1.3968.3807 1.6871.29.2539.7069.3809 1.2507.3809h.8157v5.6055c-.2538.0725-.6707.1451-1.2507.2177-.5438.0725-1.0876.1088-1.6314.1088-1.1601 0-2.2477-.1995-3.2628-.5986-.9788-.3991-1.7764-1.0703-2.3927-2.0136-.6163-.9796-.9244-2.3583-.9244-4.1361l.7069.5442c-.3625 1.3061-1.0151 2.449-1.9577 3.4286-.9063.9796-2.1026 1.7415-3.589 2.2857-1.4501.5442-3.1359.8163-5.0573.8163zm1.9576-5.6054c1.3414 0 2.5196-.254 3.5347-.7619 1.0151-.5442 1.8127-1.3243 2.3927-2.3401.5801-1.0159.8701-2.2132.8701-3.5919v-1.415l-6.6343 1.415c-1.3051.254-2.3021.6894-2.9909 1.3061-.6526.5805-.9788 1.3424-.9788 2.2858 0 .9795.3262 1.7414.9788 2.2857.6526.5442 1.5951.8163 2.8277.8163z"/><path d="m53.2974 56c-2.7915 0-5.1298-.3447-7.015-1.034-1.8489-.6894-3.3353-1.6508-4.4591-2.8844-1.0876-1.2335-1.8489-2.6485-2.284-4.2449l8.3745-.5986c.29.9433.8338 1.6871 1.6314 2.2313.8338.5442 2.0845.8163 3.7522.8163 1.9576 0 3.444-.4716 4.4591-1.415 1.0513-.907 1.577-2.3764 1.577-4.4081v-3.1021c-.6888 1.3424-1.7945 2.4309-3.3171 3.2653-1.5227.7982-3.2266 1.1973-5.1117 1.1973-2.3927 0-4.5135-.5805-6.3624-1.7415-1.849-1.1972-3.2991-2.848-4.3504-4.9523-1.0151-2.1406-1.5226-4.644-1.5226-7.5103 0-2.7936.5075-5.2607 1.5226-7.4013 1.0513-2.1406 2.4833-3.8095 4.296-5.0068 1.8489-1.2336 3.9516-1.8504 6.308-1.8504 2.1389 0 3.9335.4717 5.3836 1.415 1.4864.9433 2.6102 2.195 3.3715 3.7551v-4.517h7.9938v26.2857c0 2.6123-.5981 4.771-1.7945 6.4762-1.1963 1.7415-2.864 3.0476-5.0029 3.9184-2.139.8707-4.6223 1.3061-7.45 1.3061zm-.0544-16.2177c1.8852 0 3.3715-.7256 4.4591-2.1769 1.1239-1.4512 1.6858-3.4648 1.6858-6.0408 0-1.7052-.2538-3.1746-.7613-4.4081-.4713-1.2336-1.1782-2.1769-2.1208-2.83-.9064-.653-1.994-.9796-3.2628-.9796-1.9577 0-3.4803.7438-4.5679 2.2313-1.0876 1.4876-1.6314 3.483-1.6314 5.9864 0 2.5397.5619 4.5533 1.6858 6.0408 1.1238 1.4513 2.6283 2.1769 4.5135 2.1769z"/><path d="m86.1983 47.8367c-2.9727 0-5.5648-.6167-7.7763-1.8503-2.1752-1.2698-3.879-3.0476-5.1117-5.3333-1.1963-2.2858-1.7945-4.9706-1.7945-8.0545s.5982-5.7505 1.7945-8c1.2327-2.2857 2.9365-4.0635 5.1117-5.3333s4.7492-1.9048 7.7219-1.9048c2.9003 0 5.4199.635 7.5588 1.9048s3.7885 3.0839 4.9486 5.4422c1.1963 2.3583 1.7947 5.1701 1.7947 8.4354v1.6326h-20.5013c.1087 2.322.725 4.0454 1.8489 5.1701 1.1601 1.1247 2.6827 1.6871 4.5679 1.6871 1.3776 0 2.5195-.2903 3.4259-.8708.9425-.5805 1.6132-1.4694 2.012-2.6667l8.2116.4898c-.7616 2.9025-2.3748 5.1701-4.84 6.8028-2.4653 1.6326-5.4561 2.4489-8.9727 2.4489zm-6.2536-18.068h12.1266c-.1087-2.1406-.7069-3.737-1.7945-4.7891-1.0514-1.0522-2.429-1.5782-4.1329-1.5782s-3.1177.5623-4.2416 1.687c-1.0876 1.0885-1.7401 2.6486-1.9576 4.6803z"/><path d="m104.399 47.1837v-29.1701h7.342l.326 8.5442-1.033-.2721c.29-2.1769.87-3.9184 1.74-5.2245.906-1.3061 2.03-2.2494 3.371-2.8299 1.342-.5805 2.81-.8708 4.405-.8708 2.103 0 3.879.4536 5.329 1.3606 1.487.907 2.611 2.195 3.372 3.8639.797 1.6327 1.196 3.5737 1.196 5.8232v18.7755h-8.157v-16.0544c0-1.5601-.127-2.8844-.38-3.9728-.254-1.0885-.707-1.9048-1.36-2.449-.652-.5805-1.559-.8708-2.719-.8708-1.704 0-3.009.635-3.915 1.9048-.907 1.2336-1.36 3.0295-1.36 5.3878v16.0544z"/><path d="m146.716 47.1837c-3.009 0-5.22-.6894-6.634-2.0681-1.414-1.4149-2.121-3.6462-2.121-6.6938v-27.2653h8.157v26.2857c0 1.4149.29 2.3764.87 2.8843.616.508 1.523.7619 2.719.7619h4.078v6.0953zm-13.432-23.0749v-6.0952h20.501v6.0952z"/><path d="m169.384 8h6.58l-10.441 39.1837h-6.58z"/><path d="m182.197 55.3469v-37.1156h5.438l.163 6.2041-.652-.3266c.725-2.1405 1.921-3.7551 3.589-4.8435 1.667-1.1247 3.589-1.6871 5.764-1.6871 2.828 0 5.148.7075 6.96 2.1225 1.849 1.3787 3.209 3.2109 4.079 5.4966.906 2.2857 1.359 4.7891 1.359 7.5102s-.453 5.2245-1.359 7.5102c-.87 2.2857-2.23 4.136-4.079 5.551-1.812 1.3787-4.132 2.068-6.96 2.068-1.45 0-2.81-.2539-4.079-.7619-1.268-.5079-2.356-1.2154-3.262-2.1224-.87-.9433-1.487-2.0499-1.849-3.3197l.652-.6531v14.3673zm13.269-12.517c2.32 0 4.133-.8889 5.438-2.6666 1.341-1.7778 2.012-4.2631 2.012-7.4558 0-3.1928-.671-5.678-2.012-7.4558-1.305-1.7778-3.118-2.6667-5.438-2.6667-1.523 0-2.846.381-3.97 1.1429-1.124.7256-1.994 1.8503-2.61 3.3741-.617 1.5238-.925 3.3923-.925 5.6055 0 2.2131.29 4.0816.87 5.6054.617 1.5238 1.487 2.6667 2.611 3.4286 1.16.7256 2.501 1.0884 4.024 1.0884z"/><path d="m220.236 47.1837c-1.885 0-3.407-.4898-4.567-1.4694-1.161-.9796-1.741-2.5397-1.741-4.6803v-32.48978h5.765v31.94558c0 .6531.163 1.1429.489 1.4694.363.3265.87.4898 1.523.4898h2.284v4.7347z"/><path d="m236.238 47.8367c-3.009 0-5.42-.6893-7.233-2.068-1.776-1.3787-2.664-3.3197-2.664-5.8231s.743-4.4445 2.229-5.8232c1.523-1.4149 3.861-2.4308 7.015-3.0476l9.952-1.9047c0-2.2495-.526-3.9184-1.577-5.0068-1.052-1.1248-2.611-1.6871-4.677-1.6871-1.849 0-3.299.4172-4.35 1.2517-1.052.7982-1.777 1.9955-2.176 3.5918l-5.927-.3809c.544-2.9025 1.885-5.1882 4.024-6.8572 2.175-1.6689 4.985-2.5034 8.429-2.5034 3.915 0 6.888 1.0522 8.918 3.1565 2.067 2.068 3.1 4.9887 3.1 8.7619v11.2653c0 .6893.109 1.1791.326 1.4694.254.254.653.3809 1.196.3809h1.034v4.5715c-.182.0363-.472.0725-.87.1088-.399.0363-.816.0544-1.251.0544-1.233 0-2.302-.1995-3.209-.5986-.87-.3991-1.522-1.0522-1.957-1.9592-.435-.9433-.653-2.195-.653-3.7551l.598.2721c-.29 1.2699-.924 2.3946-1.903 3.3742-.942.9796-2.157 1.7596-3.643 2.3401-1.45.5442-3.027.8163-4.731.8163zm.924-4.5714c1.74 0 3.227-.3265 4.459-.9796 1.233-.6893 2.194-1.6326 2.882-2.8299.689-1.1973 1.034-2.5578 1.034-4.0817v-1.8503l-8.484 1.6327c-1.74.3265-2.972.8526-3.697 1.5782-.689.6893-1.034 1.5782-1.034 2.6667 0 1.2335.417 2.195 1.251 2.8843.87.6531 2.066.9796 3.589.9796z"/><path d="m257.636 47.1837v-28.9524h5.275l.217 7.7279-.707-.381c.327-1.8866.943-3.4104 1.849-4.5714.907-1.161 2.012-2.0136 3.317-2.5578 1.306-.5805 2.719-.8708 4.242-.8708 2.175 0 3.97.4898 5.384 1.4694 1.45.9433 2.537 2.2495 3.262 3.9184.762 1.6326 1.142 3.5011 1.142 5.6054v18.6123h-5.764v-16.8708c0-1.7052-.181-3.1383-.544-4.2993-.362-1.161-.96-2.0499-1.794-2.6667-.834-.6167-1.922-.9251-3.263-.9251-2.03 0-3.68.6712-4.948 2.0136-1.269 1.3424-1.904 3.3016-1.904 5.8775v16.8708z"/><path d="m299.949 47.8367c-2.828 0-5.275-.6167-7.341-1.8503-2.031-1.2336-3.608-2.9932-4.731-5.2789-1.088-2.2857-1.632-4.9524-1.632-8s.544-5.6962 1.632-7.9456c1.123-2.2857 2.7-4.0453 4.731-5.2789 2.03-1.2698 4.423-1.9048 7.178-1.9048 2.61 0 4.912.6168 6.906 1.8504 1.994 1.1972 3.535 2.9387 4.622 5.2245 1.124 2.2857 1.686 5.043 1.686 8.2721v1.4694h-20.773c.145 2.8299.888 4.9523 2.23 6.3673 1.377 1.415 3.226 2.1225 5.546 2.1225 1.704 0 3.118-.3991 4.242-1.1973s1.903-1.8685 2.338-3.2109l5.982.3809c-.761 2.6849-2.266 4.8617-4.514 6.5307-2.211 1.6326-4.912 2.4489-8.102 2.4489zm-7.722-17.7959h14.682c-.181-2.5759-.924-4.4807-2.229-5.7143-1.269-1.2335-2.9-1.8503-4.894-1.8503-2.067 0-3.771.6531-5.112 1.9592-1.305 1.2698-2.121 3.1383-2.447 5.6054z"/></g></svg>

package/assets/codex-plugin/assets/logo.svg

@@ -0,0 +1 @@
+<svg fill="none" height="64" viewBox="0 0 320 64" width="320" xmlns="http://www.w3.org/2000/svg"><g fill="#000"><path d="m18.2234 47.8367c-3.009 0-5.4742-.6893-7.3957-2.068-1.88512-1.415-2.8277-3.3741-2.8277-5.8775 0-2.576.79757-4.5533 2.3927-5.932 1.6314-1.415 4.0241-2.449 7.1781-3.1021l9.4077-1.8503c0-1.8866-.4351-3.3016-1.3051-4.2449-.8338-.9796-2.0483-1.4694-3.6435-1.4694-1.5588 0-2.7733.3628-3.6434 1.0885-.8701.6893-1.432 1.7233-1.6858 3.102l-8.21128-.381c.54379-3.1927 1.97578-5.6054 4.29598-7.2381 2.3565-1.6689 5.438-2.5034 9.2445-2.5034 4.3504 0 7.6132 1.0341 9.7884 3.1021 2.2114 2.068 3.3171 5.0975 3.3171 9.0884v9.9592c0 .8345.1269 1.3968.3807 1.6871.29.2539.7069.3809 1.2507.3809h.8157v5.6055c-.2538.0725-.6707.1451-1.2507.2177-.5438.0725-1.0876.1088-1.6314.1088-1.1601 0-2.2477-.1995-3.2628-.5986-.9788-.3991-1.7764-1.0703-2.3927-2.0136-.6163-.9796-.9244-2.3583-.9244-4.1361l.7069.5442c-.3625 1.3061-1.0151 2.449-1.9577 3.4286-.9063.9796-2.1026 1.7415-3.589 2.2857-1.4501.5442-3.1359.8163-5.0573.8163zm1.9576-5.6054c1.3414 0 2.5196-.254 3.5347-.7619 1.0151-.5442 1.8127-1.3243 2.3927-2.3401.5801-1.0159.8701-2.2132.8701-3.5919v-1.415l-6.6343 1.415c-1.3051.254-2.3021.6894-2.9909 1.3061-.6526.5805-.9788 1.3424-.9788 2.2858 0 .9795.3262 1.7414.9788 2.2857.6526.5442 1.5951.8163 2.8277.8163z"/><path d="m53.2974 56c-2.7915 0-5.1298-.3447-7.015-1.034-1.8489-.6894-3.3353-1.6508-4.4591-2.8844-1.0876-1.2335-1.8489-2.6485-2.284-4.2449l8.3745-.5986c.29.9433.8338 1.6871 1.6314 2.2313.8338.5442 2.0845.8163 3.7522.8163 1.9576 0 3.444-.4716 4.4591-1.415 1.0513-.907 1.577-2.3764 1.577-4.4081v-3.1021c-.6888 1.3424-1.7945 2.4309-3.3171 3.2653-1.5227.7982-3.2266 1.1973-5.1117 1.1973-2.3927 0-4.5135-.5805-6.3624-1.7415-1.849-1.1972-3.2991-2.848-4.3504-4.9523-1.0151-2.1406-1.5226-4.644-1.5226-7.5103 0-2.7936.5075-5.2607 1.5226-7.4013 1.0513-2.1406 2.4833-3.8095 4.296-5.0068 1.8489-1.2336 3.9516-1.8504 6.308-1.8504 2.1389 0 3.9335.4717 5.3836 1.415 1.4864.9433 2.6102 2.195 3.3715 3.7551v-4.517h7.9938v26.2857c0 2.6123-.5981 4.771-1.7945 6.4762-1.1963 1.7415-2.864 3.0476-5.0029 3.9184-2.139.8707-4.6223 1.3061-7.45 1.3061zm-.0544-16.2177c1.8852 0 3.3715-.7256 4.4591-2.1769 1.1239-1.4512 1.6858-3.4648 1.6858-6.0408 0-1.7052-.2538-3.1746-.7613-4.4081-.4713-1.2336-1.1782-2.1769-2.1208-2.83-.9064-.653-1.994-.9796-3.2628-.9796-1.9577 0-3.4803.7438-4.5679 2.2313-1.0876 1.4876-1.6314 3.483-1.6314 5.9864 0 2.5397.5619 4.5533 1.6858 6.0408 1.1238 1.4513 2.6283 2.1769 4.5135 2.1769z"/><path d="m86.1983 47.8367c-2.9727 0-5.5648-.6167-7.7763-1.8503-2.1752-1.2698-3.879-3.0476-5.1117-5.3333-1.1963-2.2858-1.7945-4.9706-1.7945-8.0545s.5982-5.7505 1.7945-8c1.2327-2.2857 2.9365-4.0635 5.1117-5.3333s4.7492-1.9048 7.7219-1.9048c2.9003 0 5.4199.635 7.5588 1.9048s3.7885 3.0839 4.9486 5.4422c1.1963 2.3583 1.7947 5.1701 1.7947 8.4354v1.6326h-20.5013c.1087 2.322.725 4.0454 1.8489 5.1701 1.1601 1.1247 2.6827 1.6871 4.5679 1.6871 1.3776 0 2.5195-.2903 3.4259-.8708.9425-.5805 1.6132-1.4694 2.012-2.6667l8.2116.4898c-.7616 2.9025-2.3748 5.1701-4.84 6.8028-2.4653 1.6326-5.4561 2.4489-8.9727 2.4489zm-6.2536-18.068h12.1266c-.1087-2.1406-.7069-3.737-1.7945-4.7891-1.0514-1.0522-2.429-1.5782-4.1329-1.5782s-3.1177.5623-4.2416 1.687c-1.0876 1.0885-1.7401 2.6486-1.9576 4.6803z"/><path d="m104.399 47.1837v-29.1701h7.342l.326 8.5442-1.033-.2721c.29-2.1769.87-3.9184 1.74-5.2245.906-1.3061 2.03-2.2494 3.371-2.8299 1.342-.5805 2.81-.8708 4.405-.8708 2.103 0 3.879.4536 5.329 1.3606 1.487.907 2.611 2.195 3.372 3.8639.797 1.6327 1.196 3.5737 1.196 5.8232v18.7755h-8.157v-16.0544c0-1.5601-.127-2.8844-.38-3.9728-.254-1.0885-.707-1.9048-1.36-2.449-.652-.5805-1.559-.8708-2.719-.8708-1.704 0-3.009.635-3.915 1.9048-.907 1.2336-1.36 3.0295-1.36 5.3878v16.0544z"/><path d="m146.716 47.1837c-3.009 0-5.22-.6894-6.634-2.0681-1.414-1.4149-2.121-3.6462-2.121-6.6938v-27.2653h8.157v26.2857c0 1.4149.29 2.3764.87 2.8843.616.508 1.523.7619 2.719.7619h4.078v6.0953zm-13.432-23.0749v-6.0952h20.501v6.0952z"/><path d="m169.384 8h6.58l-10.441 39.1837h-6.58z"/><path d="m182.197 55.3469v-37.1156h5.438l.163 6.2041-.652-.3266c.725-2.1405 1.921-3.7551 3.589-4.8435 1.667-1.1247 3.589-1.6871 5.764-1.6871 2.828 0 5.148.7075 6.96 2.1225 1.849 1.3787 3.209 3.2109 4.079 5.4966.906 2.2857 1.359 4.7891 1.359 7.5102s-.453 5.2245-1.359 7.5102c-.87 2.2857-2.23 4.136-4.079 5.551-1.812 1.3787-4.132 2.068-6.96 2.068-1.45 0-2.81-.2539-4.079-.7619-1.268-.5079-2.356-1.2154-3.262-2.1224-.87-.9433-1.487-2.0499-1.849-3.3197l.652-.6531v14.3673zm13.269-12.517c2.32 0 4.133-.8889 5.438-2.6666 1.341-1.7778 2.012-4.2631 2.012-7.4558 0-3.1928-.671-5.678-2.012-7.4558-1.305-1.7778-3.118-2.6667-5.438-2.6667-1.523 0-2.846.381-3.97 1.1429-1.124.7256-1.994 1.8503-2.61 3.3741-.617 1.5238-.925 3.3923-.925 5.6055 0 2.2131.29 4.0816.87 5.6054.617 1.5238 1.487 2.6667 2.611 3.4286 1.16.7256 2.501 1.0884 4.024 1.0884z"/><path d="m220.236 47.1837c-1.885 0-3.407-.4898-4.567-1.4694-1.161-.9796-1.741-2.5397-1.741-4.6803v-32.48978h5.765v31.94558c0 .6531.163 1.1429.489 1.4694.363.3265.87.4898 1.523.4898h2.284v4.7347z"/><path d="m236.238 47.8367c-3.009 0-5.42-.6893-7.233-2.068-1.776-1.3787-2.664-3.3197-2.664-5.8231s.743-4.4445 2.229-5.8232c1.523-1.4149 3.861-2.4308 7.015-3.0476l9.952-1.9047c0-2.2495-.526-3.9184-1.577-5.0068-1.052-1.1248-2.611-1.6871-4.677-1.6871-1.849 0-3.299.4172-4.35 1.2517-1.052.7982-1.777 1.9955-2.176 3.5918l-5.927-.3809c.544-2.9025 1.885-5.1882 4.024-6.8572 2.175-1.6689 4.985-2.5034 8.429-2.5034 3.915 0 6.888 1.0522 8.918 3.1565 2.067 2.068 3.1 4.9887 3.1 8.7619v11.2653c0 .6893.109 1.1791.326 1.4694.254.254.653.3809 1.196.3809h1.034v4.5715c-.182.0363-.472.0725-.87.1088-.399.0363-.816.0544-1.251.0544-1.233 0-2.302-.1995-3.209-.5986-.87-.3991-1.522-1.0522-1.957-1.9592-.435-.9433-.653-2.195-.653-3.7551l.598.2721c-.29 1.2699-.924 2.3946-1.903 3.3742-.942.9796-2.157 1.7596-3.643 2.3401-1.45.5442-3.027.8163-4.731.8163zm.924-4.5714c1.74 0 3.227-.3265 4.459-.9796 1.233-.6893 2.194-1.6326 2.882-2.8299.689-1.1973 1.034-2.5578 1.034-4.0817v-1.8503l-8.484 1.6327c-1.74.3265-2.972.8526-3.697 1.5782-.689.6893-1.034 1.5782-1.034 2.6667 0 1.2335.417 2.195 1.251 2.8843.87.6531 2.066.9796 3.589.9796z"/><path d="m257.636 47.1837v-28.9524h5.275l.217 7.7279-.707-.381c.327-1.8866.943-3.4104 1.849-4.5714.907-1.161 2.012-2.0136 3.317-2.5578 1.306-.5805 2.719-.8708 4.242-.8708 2.175 0 3.97.4898 5.384 1.4694 1.45.9433 2.537 2.2495 3.262 3.9184.762 1.6326 1.142 3.5011 1.142 5.6054v18.6123h-5.764v-16.8708c0-1.7052-.181-3.1383-.544-4.2993-.362-1.161-.96-2.0499-1.794-2.6667-.834-.6167-1.922-.9251-3.263-.9251-2.03 0-3.68.6712-4.948 2.0136-1.269 1.3424-1.904 3.3016-1.904 5.8775v16.8708z"/><path d="m299.949 47.8367c-2.828 0-5.275-.6167-7.341-1.8503-2.031-1.2336-3.608-2.9932-4.731-5.2789-1.088-2.2857-1.632-4.9524-1.632-8s.544-5.6962 1.632-7.9456c1.123-2.2857 2.7-4.0453 4.731-5.2789 2.03-1.2698 4.423-1.9048 7.178-1.9048 2.61 0 4.912.6168 6.906 1.8504 1.994 1.1972 3.535 2.9387 4.622 5.2245 1.124 2.2857 1.686 5.043 1.686 8.2721v1.4694h-20.773c.145 2.8299.888 4.9523 2.23 6.3673 1.377 1.415 3.226 2.1225 5.546 2.1225 1.704 0 3.118-.3991 4.242-1.1973s1.903-1.8685 2.338-3.2109l5.982.3809c-.761 2.6849-2.266 4.8617-4.514 6.5307-2.211 1.6326-4.912 2.4489-8.102 2.4489zm-7.722-17.7959h14.682c-.181-2.5759-.924-4.4807-2.229-5.7143-1.269-1.2335-2.9-1.8503-4.894-1.8503-2.067 0-3.771.6531-5.112 1.9592-1.305 1.2698-2.121 3.1383-2.447 5.6054z"/></g></svg>

package/assets/codex-plugin/skills/agentplane/SKILL.md

@@ -0,0 +1,35 @@
+---
+name: agentplane
+description: Use when a repository uses AgentPlane or the user wants a governed git-native workflow for planning, task execution, verification, and closure.
+---
+
+# AgentPlane
+
+Use AgentPlane through its CLI instead of editing `.agentplane/` state directly.
+
+## When to use
+
+- The repository already contains `AGENTS.md` or `.agentplane/`.
+- The user wants to initialize AgentPlane in a repository.
+- The user wants explicit planning, task IDs, verification evidence, or `branch_pr` worktrees.
+
+## Startup
+
+1. If the repository is not initialized, run `agentplane init`.
+2. Run `agentplane quickstart`.
+3. Inspect `AGENTS.md`, `agentplane task list`, `git status --short --untracked-files=no`, and `git rev-parse --abbrev-ref HEAD`.
+4. Use `agentplane role ORCHESTRATOR` while planning and approvals are active.
+5. Switch to `agentplane role <ROLE>` before owner-scoped execution or verification.
+
+## Rules
+
+- Treat `AGENTS.md`, `agentplane quickstart`, and `agentplane role <ROLE>` as the policy surface.
+- Use `agentplane task ...`, `agentplane work ...`, `agentplane verify ...`, and `agentplane finish ...`; do not edit `.agentplane/tasks.json` manually.
+- In `branch_pr`, start from `agentplane work start <task-id> --agent <ROLE> --slug <slug> --worktree`.
+- Keep repository artifacts in English unless the user explicitly requests another language for a specific artifact.
+- Record verification evidence in the task README and through `agentplane verify`.
+
+## Limits
+
+- This plugin bundles workflow guidance only. It does not install the `agentplane` binary for you.
+- If `agentplane` is missing from `PATH`, install it first, then use the workflow commands above.

package/assets/framework.manifest.json

@@ -57,6 +57,13 @@
       "merge_strategy": "agent_json_3way",
       "required": true
     },
+    {
+      "path": ".agentplane/agents/SKILL_EXTRACTOR.json",
+      "source_path": "agents/SKILL_EXTRACTOR.json",
+      "type": "json",
+      "merge_strategy": "agent_json_3way",
+      "required": true
+    },
     {
       "path": ".agentplane/agents/TESTER.json",
       "source_path": "agents/TESTER.json",

package/assets/policy/governance.md

@@ -2,12 +2,14 @@
 
 ## Incident source of truth
 
-- `.agentplane/policy/incidents.md` is the single incident registry.
-- Incident-derived and situational rules MUST be added only to `incidents.md`.
+- `.agentplane/policy/incidents.md` is the active incident registry for unresolved incidents that still need operator attention or follow-up engineering work.
+- `docs/developer/incident-archive.mdx` is the historical archive for stabilized or externally mitigated incidents that no longer belong in the active registry.
+- Incident-derived and situational rules MUST be added to `incidents.md` first while the incident remains active; once it is no longer active, move the entry to the archive instead of keeping it in the active file.
 - MUST NOT create additional incident policy files under `.agentplane/policy/`.
 - New reusable operational incidents SHOULD be promoted from task `Findings` via `agentplane finish` or `agentplane incidents collect <task-id>`.
 - Auto-promotion is reserved for resolved reusable findings marked `Fixability: external` or `Fixability: repo-fixable` (or the compatibility markers `IncidentExternal: true` / `IncidentInternal: true`); optional `IncidentScope`, `IncidentAdvice`, `IncidentRule`, `IncidentTags`, and `IncidentMatch` fields override the inferred registry entry when needed.
 - Normal startup MUST NOT bulk-load `incidents.md`; targeted lookup for analogous work is allowed through `task start-ready` and `agentplane incidents advise`.
+- Closed incidents MAY be removed from `.agentplane/policy/incidents.md`, but only after their final state and evidence have been preserved in `docs/developer/incident-archive.mdx`.
 
 ## Stabilization criteria
 

package/assets/policy/incidents.md

@@ -1,22 +1,7 @@
 # Policy Incidents Log
 
 - Append-only. Required fields: `id`, `date`, `scope`, `failure`, `rule`, `evidence`, `enforcement`, `state`; optional: `tags`, `match`, `advice`, `source_task`, `fixability`.
-- id: INC-20260308-01 | date: 2026-03-08 | scope: release apply internal push path | failure: release apply re-entered local pre-push hooks and could stall after creating the local release commit and tag | rule: Release orchestration MUST push its own release refs without recursively re-entering local pre-push hooks. | evidence: task 202603061532-9Y41NM; docs/developer/cli-bug-ledger-v0-3-x.mdx entry 4 | enforcement: test + command implementation | state: stabilized
-- id: INC-20260308-02 | date: 2026-03-08 | scope: stale-dist guard in framework checkout | failure: stale-dist enforcement treated git dirtiness as stale runtime and blocked diagnostics or rebuilt checkouts incorrectly | rule: Stale-dist freshness MUST compare current runtime inputs against the recorded build snapshot, and read-only diagnostics MUST warn-and-run instead of hard-failing on dirty runtime trees. | evidence: tasks 202603072032-2M0V8V, 202603072032-1BC7VQ, 202603072032-V9VGT2, 202603072032-4D9ASG | enforcement: test + runtime guard | state: stabilized
-- id: INC-20260308-03 | date: 2026-03-08 | scope: framework checkout PATH resolution | failure: contributors inside the framework repo could execute an older global agentplane binary instead of the checkout they were editing | rule: Inside the framework checkout, agentplane resolved from PATH MUST hand off to the repo-local runtime by default unless an explicit global opt-out is set. | evidence: tasks 202603071647-M0Q79C, 202603071647-Y4BZ1T, 202603071647-25WS52 | enforcement: test + wrapper logic | state: stabilized
-- id: INC-20260308-04 | date: 2026-03-08 | scope: release mutation generated surfaces | failure: release apply could leave version-sensitive generated docs stale until later parity checks failed | rule: Release mutation MUST regenerate and stage generated docs that encode released package versions as part of the release commit itself. | evidence: task 202603071745-T3QE04; docs/developer/cli-bug-ledger-v0-3-x.mdx entry 5 | enforcement: test + release mutation | state: stabilized
-- id: INC-20260308-05 | date: 2026-03-08 | scope: release mutation repository CLI expectation | failure: repository-owned framework.cli.expected_version could drift behind the actual released version because release apply did not persist it | rule: Release mutation MUST keep framework.cli.expected_version aligned with the released package version whenever repository config is present. | evidence: tasks 202603081315-Y4D6AE, 202603081538-GF7P9C; docs/developer/cli-bug-ledger-v0-3-x.mdx entry 3 | enforcement: test + release mutation | state: stabilized
-- id: INC-20260407-01 | date: 2026-04-07 | scope: branch_pr GitHub transport helpers | failure: GitHub transport intermittently failed with GraphQL EOF, TLS handshake errors, and SSL_ERROR_SYSCALL during PR creation, remote-check waiting, and reconcile helpers | advice: treat transient GitHub transport failures as retriable, prefer bounded polling or REST fallbacks over single-shot watch flows, and surface auth or usage failures immediately | rule: GitHub-dependent workflow helpers MUST classify EOF/TLS/SSL transport failures as transient and retry with bounded backoff; they MUST surface auth and usage failures immediately instead of looping or failing opaquely. | evidence: tasks 202604062101-XYXG7Y, 202604062309-QE4CX6, 202604050745-18JJ5E | enforcement: test + workflow helper | state: open
-- id: INC-20260407-02 | date: 2026-04-07 | scope: protected-main branch_pr closure permissions | failure: hosted branch_pr closure could not create follow-up PRs when the GitHub App or Actions token lacked PR creation rights, leaving manual closure tails after the task PR was already merged | advice: preserve deterministic closure metadata in task artifacts and complete the closure PR from an authenticated local session when hosted automation lacks create-PR permission | rule: Protected-main branch_pr closure MUST preserve enough task metadata for deterministic manual reconciliation when hosted automation cannot create the closure PR due to external GitHub permission limits. | evidence: tasks 202604032235-G375FB, 202604050745-18JJ5E, 202604062153-RSJFC2 | enforcement: manual + workflow | state: open
-- id: INC-20260407-03 | date: 2026-04-07 | scope: task findings incident promotion | failure: Structured findings needed hidden promote/external flags before incidents collection could see them. | advice: Use task findings add defaults for reusable incident candidates; use --local-only only for task-scoped notes. | rule: Structured findings intended as reusable workflow advice MUST promote by default; task-local-only notes MUST opt out explicitly with --local-only. | evidence: task 202604070754-ZD0ZAZ | enforcement: manual | state: open
-- id: INC-20260407-04 | date: 2026-04-07 | scope: task normalize hosted reconcile target selection | failure: GitHub EOF or TLS transport failures during hosted branch_pr reconcile could abort task normalize before it reached the known stale task because the command scanned every candidate task. | advice: When GitHub transport is flaky, reconcile only the known task ids instead of scanning the full branch_pr history. | rule: Hosted reconcile commands MUST support explicit task-id scoping so known drift can be resolved without depending on unrelated GitHub lookups. | evidence: task 202604071853-XGX2YJ; commit 5fd312cceb20 | enforcement: manual | state: open
-- id: INC-20260409-01 | date: 2026-04-09 | scope: branch_pr work-start base task README cleanup | failure: work start --worktree left untracked .agentplane/tasks/<task-id>/README.md copies in the base checkout and later git pull could block once upstream tracked the same paths | rule: branch_pr work start MUST remove base-checkout task README copies that were only materialized for the worktree, while keeping the worktree-local copies intact. | evidence: task 202604081931-77V6J5 | enforcement: test + command implementation | state: stabilized
-- id: INC-20260409-02 | date: 2026-04-09 | scope: branch_pr follow-up orchestration helpers | match: branch_pr, integrate, pr artifacts, pr meta, wait-remote-checks, remote checks, multi pr | failure: integrate recovery assumed PR artifacts already existed and the remote-check wait helper only accepted one PR target, forcing manual base-side hydration and serial closure-wave waiting. | advice: keep integrate able to recover PR metadata without a pre-hydrated base checkout and let remote-check waiting accept explicit PR batches during closure waves. | rule: branch_pr follow-up helpers MUST recover missing PR artifacts from available branch or hosted metadata and MUST accept explicit multi-PR batches so integrate and remote-check waiting stay runnable during closure waves. | evidence: tasks 202604091136-SR7Z25, 202604091136-V5N3P8; fixes 202604091218-WWSX2G, 202604091218-8S07FZ | enforcement: test + command implementation | state: open
-- id: INC-20260409-03 | date: 2026-04-09 | scope: Make branch_pr hosted-merge reconcile and task normalize resolve GitHub auth from the user's existing gh login, without requiring a manual GH_TOKEN export in the shell. | tags: code, github, workflow | match: code, github, workflow, make, branch, hosted, merge, reconcile, and, task, normalize, resolve, auth, from, the, user | failure: Repo dotenv loading could inject GITHUB_TOKEN into gh subprocesses and override a valid gh keyring session during hosted merge sync. | advice: Track auth vars loaded only from repo dotenv and strip them from gh child env, while preserving explicit shell or CI auth tokens and HOME-based gh sessions. | rule: Analogous Make branch_pr hosted-merge reconcile and task normalize resolve GitHub auth from the user's existing gh login, without requiring a manual GH_TOKEN export in the shell. work MUST review and apply the recorded external incident advice before retrying. | evidence: task 202604091841-2ZX1MQ; commit 3f71884dad3e | enforcement: manual | fixability: external | state: open
-- id: INC-20260409-04 | date: 2026-04-09 | scope: Make merged branch_pr tasks land in tracked main history as DONE with reconciled PR metadata, so pulling origin/main does not reopen them as DOING or require local normalize dirt. | tags: code, tasks, workflow | match: code, tasks, workflow, make, merged, branch, land, tracked, main, history, done, with, reconciled, metadata, pulling, origin | failure: Hosted-close recovery had to be driven one task at a time even when multiple remote task-close branches were already waiting, so merged tasks stayed DOING on main longer than necessary. | advice: Allow task hosted-close-pr to accept multiple task ids in one invocation so closure PR batches can be materialized deterministically from the existing remote task-close branches. | rule: Analogous Make merged branch_pr tasks land in tracked main history as DONE with reconciled PR metadata, so pulling origin/main does not reopen them as DOING or require local normalize dirt. work MUST review and apply the recorded external incident advice before retrying. | evidence: task 202604091841-PX5WAV | enforcement: manual | fixability: external | state: open
-- id: INC-20260409-05 | date: 2026-04-09 | scope: branch_pr verify/finish incident no-op messaging | tags: incidents, workflow, ux | match: incidents, workflow, ux, branch, verify, finish, incident, messaging, explain, registry, outcome, explicitly, and, operators, still, misread | failure: Lifecycle no-op output for verify and finish looked indistinguishable from a broken incidents pipeline, so operators could not tell when incidents.md stayed unchanged only because the note/body was plain text. | advice: Print context-specific verify and finish messages that explicitly name incidents.md, explain that plain notes stay task-local, and point operators at observation/impact/resolution fields or explicit collection on base. | rule: Analogous branch_pr verify/finish incident no-op messaging work MUST review and apply the recorded external incident advice before retrying. | evidence: task 202604092105-RF8TWW | enforcement: manual | fixability: repo-fixable | state: open
-- id: INC-20260410-01 | date: 2026-04-10 | scope: Preflight hides cross-task workflow artifact drift when tracked status looks clean. | tags: workflow, git, ux, code | match: workflow, git, ux, code, preflight, hides, cross, task, artifact, drift, when, tracked, status, looks, clean, expose | failure: Preflight could report a tracked-clean working tree while untracked .agentplane/tasks artifacts from other task ids were still present and capable of breaking later integrate or close flows. | advice: Preflight now inspects full changed paths under the workflow task directory, reports task artifact drift explicitly in JSON/text output, and points operators at git status --short --untracked-files=all -- .agentplane/tasks. | rule: Analogous Preflight hides cross-task workflow artifact drift when tracked status looks clean. work MUST review and apply the recorded external incident advice before retrying. | evidence: task 202604100023-MFGFK9; commit a2b9ccf1e12e | enforcement: manual | fixability: repo-fixable | state: open
-- id: INC-20260410-02 | date: 2026-04-10 | scope: Integrate leaves framework runtime stale after watched-source merges. | tags: workflow, runtime, git, code | match: workflow, runtime, git, code, integrate, leaves, framework, stale, after, watched, source, merges, auto, bootstrap, touches, sources | failure: Base-side integrate could land watched runtime source changes in the framework checkout, but the repo-local runtime stayed stale until the operator manually ran framework bootstrap before finish closeout. | advice: Integrate now auto-runs bun run framework:dev:bootstrap in framework checkouts when watched runtime sources changed, and falls back to explicit manual guidance only if the refresh fails. | rule: Analogous Integrate leaves framework runtime stale after watched-source merges. work MUST review and apply the recorded external incident advice before retrying. | evidence: task 202604100023-EVJWDM; commit 0f4d2f9a92e0 | enforcement: manual | fixability: repo-fixable | state: open
-- id: INC-20260410-03 | date: 2026-04-10 | scope: Integrate currently can apply task code onto the base branch and only then discover that the task branch never committed .agentplane/tasks/<task-id>/pr artifacts. Validate the branch-backed task/PR artifact set before any merge-side mutation so base never advances when closeout metadata is absent. | tags: code, workflow | match: code, workflow, integrate, currently, can, apply, task, onto, the, base, branch, and, only, then, discover, that | failure: Integrate validated task/PR metadata too late: a task branch could omit committed .agentplane/tasks/<task-id>/pr artifacts and still reach merge-side mutation before failing. | advice: Added committed-artifact validation before merge-side mutation, covered the missing-artifact and post-merge-removal regressions, and updated prepare.test mocks for the new contract. | rule: Analogous Integrate currently can apply task code onto the base branch and only then discover that the task branch never committed .agentplane/tasks/<task-id>/pr artifacts. Validate the branch-backed task/PR artifact set before any merge-side mutation so base never advances when closeout metadata is absent. work MUST review and apply the recorded external incident advice before retrying. | evidence: task 202604100213-MVAGSD | enforcement: manual | fixability: external | state: open
-- id: INC-20260410-04 | date: 2026-04-10 | scope: Verify-required task scaffolds currently seed a placeholder Verify Steps block that immediately fails plan approval. Generate concrete acceptance steps from the primary tag and any explicit verify commands so a freshly scaffolded task is reviewable without manual README surgery. | tags: code, workflow | match: code, workflow, verify, required, task, scaffolds, currently, seed, placeholder, steps, block, that, immediately, fails, plan, approval | failure: Verify-required task scaffolds could seed a placeholder Verify Steps block when no explicit verify command was supplied, so plan approval failed on a fresh task before any human refinement. | advice: Removed the placeholder path for verify-required scaffolds without explicit verify commands, updated warning text to reflect concrete seeded acceptance steps, and added regression coverage for task new, task derive, and plan approve. | rule: Analogous Verify-required task scaffolds currently seed a placeholder Verify Steps block that immediately fails plan approval. Generate concrete acceptance steps from the primary tag and any explicit verify commands so a freshly scaffolded task is reviewable without manual README surgery. work MUST review and apply the recorded external incident advice before retrying. | evidence: task 202604100213-1AAPW1 | enforcement: manual | fixability: external | state: open
-- id: INC-20260410-05 | date: 2026-04-10 | scope: Generate the next patch release plan from v0.3.10, draft release notes, prepare a release candidate branch/PR, and reconcile the current mismatch between release apply --push and the protected-main publish route before any irreversible release action. | tags: release | match: release, generate, the, next, patch, plan, from, draft, notes, prepare, candidate, branch, and, reconcile, current, mismatch | failure: Protected-main publication remains intentionally deferred because agentplane release apply --push --yes still assumes a direct push/tag route while this repository publishes via main-driven automation. | advice: Push the release branch, review the candidate, and confirm a protected-main-safe publish path before running the final release apply/tag flow. | rule: Analogous Generate the next patch release plan from v0.3.10, draft release notes, prepare a release candidate branch/PR, and reconcile the current mismatch between release apply --push and the protected-main publish route before any irreversible release action. work MUST review and apply the recorded external incident advice before retrying. | evidence: task 202604101009-36KKA9 | enforcement: manual | fixability: external | state: open
+- id: INC-20260417-01 | date: 2026-04-17 | scope: Remove version drift by updating packages/recipes version surfaces, dependency pins, and generated references to the current 0.3.13 workspace version. | tags: code, recipes, workflow | match: code, recipes, workflow, remove, version, drift, updating, packages, surfaces, dependency, pins, and, generated, references, the, current | failure: Updated recipes package metadata, dependency pins, docs reference, and release parity checks to include @agentplaneorg/recipes. | advice: Aligned version surfaces to 0.3.13 and extended the parity checker plus tests to enforce recipes parity going forward. | rule: Analogous Remove version drift by updating packages/recipes version surfaces, dependency pins, and generated references to the current 0.3.13 workspace version. work MUST review and apply the recorded external incident advice before retrying. | evidence: task 202604171154-1WZZJK; commit 45ed50d51883 | enforcement: manual | fixability: external | state: open
+- id: INC-20260417-02 | date: 2026-04-17 | scope: Remove version drift by updating packages/recipes version surfaces, dependency pins, and generated references to the current 0.3.13 workspace version. | tags: code, recipes, workflow | match: code, recipes, workflow, remove, version, drift, updating, packages, surfaces, dependency, pins, and, generated, references, the, current | failure: Aligned recipes version metadata, dependency pins, lockfile, and release check scripts so both parity and npm availability treat @agentplaneorg/recipes as a first-class release package. | advice: Updated release parity and npm availability scripts plus tests, then re-ran focused release checks. | rule: Analogous Remove version drift by updating packages/recipes version surfaces, dependency pins, and generated references to the current 0.3.13 workspace version. work MUST review and apply the recorded external incident advice before retrying. | evidence: task 202604171154-1WZZJK; commit 45ed50d51883 | enforcement: manual | fixability: external | state: open
+- id: INC-20260417-03 | date: 2026-04-17 | scope: Remove scenario-centric commands and help from the public recipes product surface so recipes stop presenting a second parallel runtime model. | tags: code, recipes, workflow | match: code, recipes, workflow, remove, scenario, centric, commands, and, help, from, the, public, product, surface, stop, presenting | failure: Removed recipes scenario commands from the public command catalog, regenerated CLI/docs inventory, and updated user/developer guidance plus help/tests to treat scenario assets as recipe-owned internals. | advice: Regenerated CLI reference and recipes inventory, updated prompt assets, and reran focused command-catalog/help tests plus freshness checks. | rule: Analogous Remove scenario-centric commands and help from the public recipes product surface so recipes stop presenting a second parallel runtime model. work MUST review and apply the recorded external incident advice before retrying. | evidence: task 202604171155-V21N6H; commit e6b8c732614a | enforcement: manual | fixability: external | state: open
+- id: INC-20260417-04 | date: 2026-04-17 | scope: Make overlay when matching conjunctive, propagate command context into runtime matching, and either fully support or remove dead command matching fields. | tags: code, recipes, workflow | match: code, recipes, workflow, make, overlay, when, matching, conjunctive, propagate, command, context, into, runtime, and, either, fully | failure: Overlay fragments with combined when predicates now require every configured predicate, and runner prompt assembly forwards command context. | advice: Replaced else-if matching with conjunctive checks, added command propagation from runner target, and covered both layers with focused tests. | rule: Analogous Make overlay when matching conjunctive, propagate command context into runtime matching, and either fully support or remove dead command matching fields. work MUST review and apply the recorded external incident advice before retrying. | evidence: task 202604171154-4M51J8; commit b09dcb42e0d3 | enforcement: manual | fixability: external | state: open

package/assets/policy/workflow.branch_pr.md

@@ -6,11 +6,13 @@ Use this module when `workflow_mode=branch_pr`.
 
 1. CHECKPOINT A: plan/approve on base checkout.
 2. Start work with dedicated task branch + worktree.
-3. Keep single-writer discipline per task worktree.
-4. Publish/update PR artifacts.
-5. Verify on task branch.
-6. CHECKPOINT B: integrate on base branch by INTEGRATOR.
-7. CHECKPOINT C: finish task(s) on base with verification evidence.
+3. Continue owner-scoped execution from the task worktree (not the base checkout).
+4. Keep single-writer discipline per task worktree.
+5. Publish/update PR artifacts from the task worktree.
+6. Verify on the task branch.
+7. CHECKPOINT B: integrate on base branch by INTEGRATOR.
+8. CHECKPOINT C: finish task(s) on base with verification evidence.
+9. Remove merged task branches/worktrees once the hosted-close/finish route has landed.
 
 ## Command contract
 
@@ -29,8 +31,11 @@ agentplane finish <task-id> --author INTEGRATOR --body "Verified: ..." --result
 - MUST NOT perform mutating actions before explicit user approval.
 - Task documentation updates MAY be batched within one turn before approval.
 - MUST run `task plan approve` then `task start-ready` as `Step 1 -> wait -> Step 2` (never parallel).
+- In `branch_pr`, `task start-ready`, `pr open`, `pr update`, and verification commands SHOULD be run from the task worktree created by `work start`.
+- `pr open` without `--sync-only` SHOULD complete in one pass: sync local artifacts, auto-publish the task branch to `origin` when it has no upstream yet, then create/link the remote GitHub PR.
 - `task start-ready` MAY surface targeted incident advice for analogous scope/tags; follow it before widening scope.
 - Keep structured resolved external findings in the task README; mark reusable ones with `Fixability: external` (or `IncidentExternal: true`) and let base-branch `finish` or `agentplane incidents collect <task-id>` promote them into `.agentplane/policy/incidents.md`, using optional `Incident*` fields only when the inferred scope/advice needs refinement. Plain `Findings` text remains task-local and does not update the shared incident registry.
 - MUST stop and request re-approval on material drift.
 - Planning and closure happen on base checkout.
 - Do not export task snapshots from task branches.
+- After merged closure, remove stale task branches/worktrees via the cleanup route instead of leaving orphaned local state behind.

package/assets/policy/workflow.release.md

@@ -8,7 +8,7 @@ Use this module when task touches release/version/publish flows.
 2. CHECKPOINT B: generate release plan and freeze version/tag target.
 3. Generate release notes with complete human-readable coverage of all task-level changes.
 4. Run release prepublish checks.
-5. CHECKPOINT C: apply release and push/tag only after all gates pass.
+5. CHECKPOINT C: choose the workflow-specific publication route after all gates pass.
 6. Record release evidence (commands, outputs, resulting version/tag).
 
 ## Command contract
@@ -18,7 +18,8 @@ git status --short --untracked-files=no
 agentplane task plan set <task-id> --text "Release plan: version=<v>, tag=<t>, scope=<...>" --updated-by <ROLE>
 agentplane task plan approve <task-id> --by ORCHESTRATOR
 agentplane release plan --patch
-agentplane release apply --push --yes
+agentplane release apply --push --yes   # direct mode only
+agentplane release candidate --push --yes   # branch_pr mode only
 agentplane verify <task-id> --ok|--rework --by <ROLE> --note "Release checks: ..."
 agentplane finish <task-id> --author <ROLE> --body "Verified: release" --result "Release <v> published" --commit <git-rev> --close-commit
 ```
@@ -29,3 +30,5 @@ agentplane finish <task-id> --author <ROLE> --body "Verified: release" --result
 - MUST NOT skip parity/version checks.
 - MUST NOT bypass required notes validation.
 - MUST stop and request re-approval if release scope/tag/version changes.
+- In `direct`, `release apply --push --yes` is the publication route and may create/push the release tag.
+- In `branch_pr`, `release apply` is not the publication route; use `release candidate --push --yes`, merge the candidate into the protected base branch, then let hosted publish run from `main`.