agentplane 0.6.11 → 0.6.12

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/assets/AGENTS.md CHANGED
@@ -20,7 +20,7 @@ Detailed procedures live in canonical modules from `## CANONICAL DOCS`.
20
20
 
21
21
  - Repository type: user project initialized with `agentplane`.
22
22
  - CLI rule: prefer `ap` for compact agent-oriented commands; fall back to `agentplane`; if neither is available, stop and request installation guidance (do not invent repo-local entrypoints).
23
- - Startup shortcut: run `## COMMANDS -> Preflight`, then use `ap quickstart`; activate `ap role ORCHESTRATOR` for planning and `ap role <ROLE>` for the active owner before owner-scoped execution; then apply `## LOAD RULES` before any mutation. The guarded route is determined by `workflow.mode` in `.agentplane/WORKFLOW.md`; use `ap task brief <task-id>` and the emitted next command before manually assembling route commands. In `branch_pr`, start from the emitted `work start` route command or `ap work start ... --worktree`; in `direct`, stay in the current checkout and use the task lifecycle route.
23
+ - Startup shortcut: run `## COMMANDS -> Preflight`; use `ap quickstart`; activate `ap role ORCHESTRATOR` for planning and `ap role <ROLE>` for execution; then apply `## LOAD RULES` before mutation. The guarded route is determined by `workflow.mode` in `.agentplane/WORKFLOW.md`; treat `ap task brief <task-id>` and `ap task next-action <task-id> --explain` as the route oracle: follow the emitted checkout, blocker, and next command instead of reconstructing workflow state.
24
24
 
25
25
  <!-- /ap:fragment -->
26
26
  <!-- ap:fragment id="gateway.agents.source_of_truth.sources.of.truth" slot="source_of_truth" mutability="replaceable" -->
@@ -66,6 +66,14 @@ git status --short
66
66
  git rev-parse --abbrev-ref HEAD
67
67
  ```
68
68
 
69
+ ### Route commands
70
+
71
+ ```bash
72
+ ap task brief <task-id>
73
+ ap task next-action <task-id> --explain
74
+ ap work resume <task-id>
75
+ ```
76
+
69
77
  ### Task lifecycle
70
78
 
71
79
  ```bash
@@ -117,8 +125,10 @@ node .agentplane/policy/check-routing.mjs
117
125
 
118
126
  ## SHARED PROMPT CONTRACT
119
127
 
120
- - Outcome-first, concise, evidence-first: state goal, success criteria, constraints, stop rules, and output; use procedure only for command contracts, state machines, or irreversible gates; ask one narrow question only when missing information changes scope, task graph, security, or irreversible action.
121
- - Retrieval/progress/cache: preamble before multi-step or tool-heavy work; use `ap task active` and `ap task brief <task-id>` before manually combining task docs, route status, Verify Steps, PR metadata, and policy notes; load only matched policy, task README, Verify Steps, and relevant files; use incidents only for analogous scope/tags; final output names actions, checks, blockers/drift, and next approval; keep stable gateway/policy/role before dynamic context and never cache mutable task state.
128
+ - Outcome-first, concise, evidence-first: state goal, success criteria, constraints, stop rules, and output; use procedure only for command contracts, state machines, or irreversible gates.
129
+ - Ambiguity rule: ask one narrow question only when missing information changes scope, security, task graph, or irreversible action; otherwise act under stated assumptions.
130
+ - Route/persistence rule: for multi-step or tool-heavy work, send a short preamble, load `ap task brief <task-id>`, follow `ap task next-action <task-id> --explain`, and persist through implementation + verification unless blocked.
131
+ - Context rule: load only matched policy, task README, Verify Steps, and relevant files; never cache mutable task state; final output names actions, checks, blockers/drift, and next approval.
122
132
 
123
133
  <!-- /ap:fragment -->
124
134
  <!-- ap:fragment id="gateway.user.instructions" slot="body" mutability="append_only" -->
@@ -182,18 +192,7 @@ Role boundaries: ORCHESTRATOR = preflight + plan + approvals; PLANNER = executab
182
192
 
183
193
  ## CORE DOD
184
194
 
185
- A task is done only when all are true:
186
-
187
- 1. Approved scope is satisfied; no unresolved drift.
188
- 2. Required checks from loaded policy modules passed.
189
- 3. Security and approval gates were respected.
190
- 4. Traceability exists (task ID + updated task docs).
191
- 5. Verification evidence is recorded.
192
- 6. No unintended tracked changes remain.
193
-
194
- Detailed DoD rules are in `.agentplane/policy/dod.core.md`, `.agentplane/policy/dod.code.md`, and `.agentplane/policy/dod.docs.md`.
195
-
196
- ---
195
+ A task is done only when approved scope, loaded DoD modules, security gates, task traceability, recorded verification, and clean final tracked state all pass. Detailed DoD rules live in `.agentplane/policy/dod.core.md`, `.agentplane/policy/dod.code.md`, and `.agentplane/policy/dod.docs.md`.
197
196
 
198
197
  <!-- /ap:fragment -->
199
198
  <!-- ap:fragment id="gateway.agents.hard_constraint.size.budget" slot="hard_constraint" mutability="append_only" -->
@@ -205,8 +204,6 @@ Detailed DoD rules are in `.agentplane/policy/dod.core.md`, `.agentplane/policy/
205
204
  - Worst-case loaded policy graph (always imports + all conditional imports) MUST stay <= 600 lines.
206
205
  - Enforced by `node .agentplane/policy/check-routing.mjs`.
207
206
 
208
- ---
209
-
210
207
  <!-- /ap:fragment -->
211
208
  <!-- ap:fragment id="gateway.agents.body.canonical.docs" slot="body" mutability="replaceable" -->
212
209
 
@@ -2,7 +2,7 @@
2
2
  "schema_version": 1,
3
3
  "manifest_kind": "package",
4
4
  "package_name": "agentplane",
5
- "package_version": "0.6.11",
6
- "git_head": "f64842db3ede31bdac865dbc7b501351e4c922a3",
7
- "watched_runtime_snapshot_hash": "e8fee1bd81eec3cef2943f5f26575301e7fa43e72baac1023fa47da35b543c0b"
5
+ "package_version": "0.6.12",
6
+ "git_head": "0aef2e3f8bf5965acee1568a994ac4e63d20151b",
7
+ "watched_runtime_snapshot_hash": "23ba36ce7206a7d290a8c9341837c4bf6163c3f2699851b8a52a7715f794f97c"
8
8
  }