project-tiny-context-harness 0.2.73 → 0.2.75

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.
@@ -1,471 +1,540 @@
1
- ---
2
- name: superpowers-long-task
3
- description: Use when directly invoked for Superpowers long-running task target prompt preparation.
4
- ---
5
-
6
- # Superpowers Long Task Skill
7
-
8
- ## Package-Managed Boundary
9
-
10
- This Skill is generated by `ty-context sync` and owned by the Harness package. Do not edit the generated `superpowers-long-task` Skill directly in a consumer project.
11
-
12
- This is Tiny Context's adapter for feeding a recommended three-input long-task packet into the external Superpowers workflow. It is not a Superpowers official schema and 不是 Superpowers 官方 schema. It only makes the target-mode prompt explicit enough that the official Superpowers skills can do their intended work without losing Tiny Context context-delta, plan-conformance and acceptance authority.
13
-
14
- ## Purpose
15
-
16
- Consumes three existing upstream inputs and emits a paste-ready Superpowers target-mode prompt:
17
-
18
- - Product / Architecture Source: original intent source for scope, product logic, surface responsibility and durable architecture intent.
19
- - Technical Realization Plan: the execution blueprint and plan-conformance source.
20
- - Acceptance Checklist: the acceptance authority and final-verdict source.
21
-
22
- Use this Skill only after all three inputs already exist or are pasted in full. Two-document compatibility is allowed only when the first document explicitly contains both Product / Architecture Source and Technical Realization Plan sections; otherwise stop for a missing Technical Realization Plan. Do not generate, derive, or infer the Technical Realization Plan. Do not generate, derive, rewrite, strengthen, or repair the full checklist in this Skill. If plan items or ACs are too vague to trace, stop and ask for the missing fields. If only generic conformance or verdict rules are missing, inject this Skill's default rules into the generated prompt.
23
-
24
- This Skill does not perform task-complexity routing. Direct invocation means the user or upstream process has already selected Superpowers long-task execution. Ordinary checklist preparation, non-Superpowers target prompts or incomplete upstream packets should be handled before this Skill, normally with `/normal-long-task` or a revised upstream packet.
25
-
26
- ## Direct Invocation
27
-
28
- Use this Skill through explicit invocation:
29
-
30
- ```text
31
- /superpowers-long-task
32
- ```
33
-
34
- Do not rely on broad automatic keyword routing. `/normal-long-task` remains useful for ordinary acceptance preparation, but this Skill does not require it when the product/architecture source, technical realization plan and acceptance checklist are already supplied.
35
-
36
- ## Use Cases
37
-
38
- Use this Skill when a three-input long-task packet needs:
39
-
40
- - Superpowers target-mode prompt.
41
- - Superpowers goal-mode prompt.
42
- - Superpowers 目标模式文本.
43
- - Superpowers-compatible Codex target prompt.
44
- - Superpowers execution binding with Context Delta, plan-conformance and acceptance-evidence gates.
45
-
46
- Do not trigger merely because a plan mentions TDD or subagents. The user must ask for a Superpowers target/goal prompt or equivalent execution adapter.
47
-
48
- ## Required Three-Input Packet
49
-
50
- The input must fully expose these fields:
51
-
52
- - Product / Architecture Source path or pasted text.
53
- - original requirement source or original plan summary.
54
- - durable product intent when applicable: product capability, user flow, business state/rule, page/surface responsibility, information architecture, product ownership, status meaning, operation boundary or acceptance semantics.
55
- - durable architecture intent when applicable: module boundary, dependency direction, API/schema/data/event contract, worker/runtime/state-machine semantics, verification/deployment path or stable technical tradeoff.
56
- - Technical Realization Plan path or pasted text.
57
- - traceable plan items or sections that affect behavior.
58
- - expected implementation surfaces when applicable: code, API/schema, UI/page, worker/runtime, artifact, data, tests.
59
- - required code/API/schema/UI/worker/runtime/data/test/evidence mapping when applicable.
60
- - full-scope versus sample/optional boundaries.
61
- - explicitly non-completing shortcuts, such as local-only enhancement, old page continuing to own a moved responsibility, sampled path, plan-only work or test-only patch.
62
- - full acceptance checklist path or pasted text.
63
- - acceptance items or AC IDs.
64
- - required evidence and verification method per AC.
65
- - required tests or explicit no-test scope.
66
- - valid and invalid evidence rules.
67
- - Completion State Machine rules.
68
- - UI-Facing Gate rules when any AC touches UI.
69
- - hard blockers or an explicit no-blocker statement.
70
-
71
- If any of these are missing required fields, stop. Do not generate the Superpowers target-mode prompt. Report whether each missing field belongs in Product / Architecture Source, Technical Realization Plan, Acceptance Checklist, blocker section or Context reference. If the user supplied only a product/architecture source plus checklist, report missing Technical Realization Plan.
72
-
73
- When blocked by missing input, return a structured Missing Fields Report with:
74
-
75
- - `missing_section`.
76
- - `missing_required_fields`.
77
- - `why_blocking`.
78
- - `cannot_infer_policy`.
79
- - `required_next_input`.
80
- - `suggested_upstream_action`.
81
-
82
- The report must state that this Skill cannot infer the execution blueprint from Product / Architecture Source and cannot repair the checklist. It may recommend supplying the missing Technical Realization Plan or using `/normal-long-task` before Superpowers execution when the upstream packet is not ready.
83
-
84
- ## Source Roles
85
-
86
- - Product / Architecture Source prevents scope shrinkage and drives Product Context Delta / architecture-intent checks; it is not the code construction plan.
87
- - Technical Realization Plan is the execution blueprint and the source for `plan-conformance-matrix.*`; it is not proof.
88
- - Acceptance Checklist is the completion authority and the source for `final-acceptance-verdict.*`.
89
- - local audit records progress, candidate status, evidence, blockers and invalidating evidence only; it is not proof and must not mark final completion.
90
- - relevant Context remains the durable repo intent and boundary source.
91
- - required tests / core paths bind plan and AC gaps to executable verification.
92
-
93
- Do not let a compact target prompt override the product/architecture source, technical realization plan or full checklist. The compact prompt is direction, priority and recovery navigation only. The technical realization plan controls plan conformance; the product/architecture source prevents scope shrinkage; the full checklist controls acceptance.
94
-
95
- ## Authority Model
96
-
97
- - Product / Architecture Source owns intent, scope, non-goals, product/architecture boundaries and acceptance semantics.
98
- - Technical Realization Plan owns plan items, execution blueprint, owner/forbidden surfaces, implementation paths and plan-conformance expectations.
99
- - Acceptance Checklist owns ACs, completion semantics, required proof layers, invalid evidence rules and final acceptance state.
100
- - local audit, plan-conformance matrix, final acceptance verdict, validator output, optional proof index and auditor report are execution/evidence artifacts. They cannot narrow, rewrite or replace the upstream sources.
101
- - When sources conflict, stop or report the conflict instead of letting a downstream artifact silently change scope, plan or acceptance.
102
-
103
- ## Context Delta Assessment
104
-
105
- The prompt must require the future executor to evaluate Context before implementation using:
106
-
107
- ```text
108
- Product Context Delta: none|required
109
- Technical Context Delta: none|required
110
- Context Delta: none|required
111
- ```
112
-
113
- Any required sub-delta makes overall Context Delta required. This is prompt-level workflow discipline, not a validator gate, not a machine-enforced gate, not a phase gate and not a new document chain.
114
-
115
- `Product Context Delta: required` applies when the product/architecture source changes durable product facts such as product capability, user flow, business state/rule, page or surface responsibility, main/drilldown ownership, information architecture, user-visible terminology, status meaning, operation boundary, product/domain ownership or acceptance semantics.
116
-
117
- `Technical Context Delta: required` applies when the product/architecture source or Technical Realization Plan changes durable technical facts such as API/schema/event/data contract, module ownership, dependency direction, worker/runtime/state-machine semantics, data model, persistence, scheduling, failure/retry/recovery semantics, verification/deployment/bootstrap path or stable technical tradeoff.
118
-
119
- When overall `Context Delta: required`, the executor must update the smallest owning `project_context/**` or `DESIGN.md` fact before implementation continues. Use existing roles only: `area`, `subdomain`, `contract`, `foundation`, `verification`, `deployment`, `implementation-index` and `decision-rationale`. Do not write local audit, plan-conformance matrix, final acceptance verdict, temporary plan, sampled evidence, one-off logs, raw outputs, screenshots or PR notes into Context.
120
-
121
- For Superpowers execution, the generated prompt should use a parent/slice pattern:
122
-
123
- - Parent Context Delta: evaluate Product Context Delta, Technical Context Delta, overall Context Delta, owning Context files and whether required Context was updated before implementation.
124
- - Slice Context Delta: each implementation slice inherits the parent decision and only records whether it discovered a new durable fact.
125
- - If a slice discovers a new durable product or technical fact, it must identify the owning Context and update it before continuing.
126
- - Slice-level `none` cannot override a parent-level `required` decision.
127
-
128
- ## Plan Conformance Gate
129
-
130
- The prompt must require the future executor to create or initialize `tmp/ty-context/plan-acceptance/<plan-slug>-plan-conformance-matrix.md` and `.json` before substantial implementation, then update it after each meaningful implementation slice.
131
-
132
- Each behavior-affecting Technical Realization Plan item must have a trace entry with:
133
-
134
- - plan item id and plan requirement.
135
- - acceptance ids covered by the plan item when applicable.
136
- - expected surfaces.
137
- - implemented paths.
138
- - missing paths.
139
- - tests.
140
- - runtime or artifact evidence.
141
- - scope assessment.
142
- - status.
143
- - drift.
144
- - required proof layers, satisfied proof layers and missing required layers when the plan/checklist requires layered evidence.
145
- - substitute or sibling evidence use when any similar execution path, negative case, screenshot or artifact could be confused with the required evidence.
146
- - Context fact refs when Context Delta is required.
147
- - For Product Surface, IA or architecture-migration items: conformance type, owner surface, required user paths, forbidden primary surfaces, real page evidence, negative surface checks and default visibility requirement.
148
-
149
- Allowed plan-conformance statuses:
150
-
151
- - `complete`
152
- - `partial`
153
- - `sampled_only`
154
- - `not_implemented`
155
- - `blocked`
156
- - `scope_changed_requires_user_approval`
157
- - `contradicted_by_current_state`
158
- - `out_of_scope_NA`
159
-
160
- Hard rules:
161
-
162
- - Passing tests does not imply plan conformance.
163
- - A sampled implementation path does not imply full plan implementation.
164
- - A local audit cannot narrow plan scope or mark completion.
165
- - Scope correction requires explicit user approval or a revised product/architecture source, Technical Realization Plan and checklist.
166
- - Every behavior-affecting plan section must have an implementation trace entry.
167
- - Product Surface, IA or architecture-migration rows cannot be complete without owner surface, required user paths, real page evidence, negative surface checks for forbidden primary surfaces and Context fact refs when Context Delta is required.
168
- - A complete row cannot have unresolved `missing_required_layers`, material or critical `drift_severity`, unapproved `sibling_substitution_used`, summary-only evidence or blocking auditor findings.
169
- - Any `partial`, `sampled_only`, `not_implemented`, unresolved blocker, unapproved scope change or current contradiction prevents overall done.
170
-
171
- ## Acceptance Evidence Gate
172
-
173
- The prompt must require the future executor to generate `tmp/ty-context/plan-acceptance/<plan-slug>-final-acceptance-verdict.md` and `.json` only at the final gate, after Context Delta handling, Plan Conformance Gate and current evidence checks.
174
-
175
- Each AC verdict entry must include:
176
-
177
- - AC id or acceptance item.
178
- - related plan item ids when applicable.
179
- - status.
180
- - required evidence.
181
- - required proof chain when the checklist or plan requires multiple evidence layers.
182
- - fresh evidence.
183
- - missing evidence.
184
- - missing required layers.
185
- - drift severity.
186
- - sibling substitution used / approval source.
187
- - auditor status and findings when an auditor subagent was available.
188
- - contradictions.
189
- - decision.
190
-
191
- Allowed AC statuses:
192
-
193
- - `complete`
194
- - `partial`
195
- - `blocked`
196
- - `not_run`
197
- - `invalidated`
198
- - `out_of_scope_NA`
199
-
200
- Hard rules:
201
-
202
- - Final completion requires an AC-by-AC final acceptance verdict.
203
- - Before any completion claim, run `ty-context validate-plan-acceptance tmp/ty-context/plan-acceptance/<plan-slug>`; failure prevents final complete and must produce partial / blocker / missing-evidence output.
204
- - `validate-plan-acceptance` rejects contradictory matrix/verdict JSON, weak-proof complete rows, missing cross-references and declared surface/architecture binding gaps; it checks artifact consistency and references, not product quality.
205
- - Current API/UI/runtime/data/test contradictions override historical passing evidence.
206
- - local audit, subagent summaries, final result card text, passing test logs, stale artifacts, partial smoke, dry-run or sampled paths cannot prove completion by themselves.
207
- - Any current contradiction downgrades the affected AC and overall status.
208
- - Scope narrowing in audit does not modify acceptance unless the user approved a revised source/plan/checklist.
209
- - `out_of_scope_NA` requires explicit reason and source reference; arbitrary prose cannot waive missing evidence.
210
- - Complete AC rows cannot have unresolved `missing_required_layers`, material or critical `drift_severity`, unapproved `sibling_substitution_used`, blocking `auditor_status` or only self-certifying evidence such as local audit, matrix/verdict text, subagent summary, final card or validator pass.
211
-
212
- ## External Reviewer Evidence Gate
213
-
214
- The final verdict is not completion proof unless every complete AC can be independently reviewed from fresh command, API, UI, runtime, artifact, browser or test evidence. Evidence index, matrix rows, local audit, validator pass and summaries can point to evidence, but cannot replace evidence.
215
-
216
- For every AC whose checklist implies multiple required layers, the final verdict must record `required_proof_chain`, `fresh_evidence`, `missing_required_layers`, `drift_severity`, `sibling_substitution_used`, `auditor_status` and `auditor_findings` when applicable. These are generic evidence protocol fields; concrete business layers must come from the Acceptance Checklist, Product / Architecture Source, Technical Realization Plan or project-local Context/Skills.
217
-
218
- Evidence Ledger / proof index is optional execution indexing, not a fourth input, not durable Context and not required as a separate file. Complete plan-conformance rows and complete AC verdicts must still be evidence-traceable: cite fresh, reviewable evidence directly in the row or through an optional `evidence_id` that points to command, API, UI, runtime, artifact, browser or test evidence with enough freshness context for a reviewer to reconstruct the proof chain.
219
-
220
- ## Drift-to-Status
221
-
222
- Any plan item or AC with unresolved missing required layers, material / critical drift or a current API / UI / runtime / data / test contradiction cannot be `complete`. It must be `partial`, `blocked`, `invalidated` or `out_of_scope_NA` with explicit source reference.
223
-
224
- ## No Sibling Substitution
225
-
226
- The same execution path, negative case, screenshot or artifact class cannot substitute for the required one unless the checklist explicitly allows that substitution or marks the required layer `out_of_scope_NA`. Similar evidence is auxiliary only.
227
-
228
- ## Independent Reviewer Gate
229
-
230
- When subagents are available, add a read-only auditor after executor self-evidence and `validate-plan-acceptance`. The auditor is a gap detector, not a proof source: it must not edit code, repair artifacts or treat local audit, subagent summary, matrix/verdict text, validator pass or final card as proof. It reconstructs each AC proof chain from source/plan/checklist, checks freshness and raw evidence, rejects sibling substitution and returns `auditor_status` plus findings. Any `partial`, `blocked` or `invalidated` auditor result downgrades the affected AC unless fresh evidence closes the gap.
231
-
232
- Final gate order is fixed:
233
-
234
- 1. executor self-evidence.
235
- 2. update plan-conformance matrix.
236
- 3. update final-acceptance verdict.
237
- 4. run `ty-context validate-plan-acceptance`.
238
- 5. run read-only auditor gap review when subagents are available.
239
- 6. if auditor findings change matrix, verdict or evidence, fix the gap and rerun `ty-context validate-plan-acceptance`.
240
- 7. make a final completion claim only when self-evidence, validator consistency and auditor review have no blocking conflict.
241
-
242
- ## Goal And Acceptance Wording
243
-
244
- The Superpowers target prompt must keep three completion concepts separate:
245
-
246
- - `audit_task_complete`: the read-only audit, final-gate workflow or artifact-production task finished.
247
- - `acceptance_target_status`: the final verdict outcome for the checked plan or product target.
248
- - `product_goal_complete`: the checked plan or product target is accepted as complete.
249
-
250
- `product_goal_complete` may be true only when the final verdict overall status is `accepted` or `complete`, all required ACs are `complete` or explicit sourced `out_of_scope_NA`, `ty-context validate-plan-acceptance` passes, and any auditor has no blocking finding.
251
-
252
- When the generated prompt is used as an implementation or execution Goal mode objective, the active Codex goal is complete only when `product_goal_complete=true`. A non-accepted `acceptance_target_status` means continue implementation or report blockers / missing evidence; do not close the implementation goal as complete.
253
-
254
- A read-only audit / reporting Goal mode objective is different: when the explicit goal is only to produce an audit and verdict, `audit_task_complete` may complete that meta-goal even when `product_goal_complete=false`. In that case, if `acceptance_target_status` is `partial`, `blocked`, `invalidated`, `not_run`, `partial_not_accepted_as_complete_platform` or any other non-accepted status, the final response must say `Audit workflow completed; acceptance target not complete.` It should include complete / partial / blocked / not_run / invalidated counts when available. Do not write an unqualified `Goal achieved` and do not describe `update_goal(status="complete")` as user-target or product-goal completion in that case.
255
-
256
- ## Evidence Layer Separation
257
-
258
- Keep these layers separate in the prompt when relevant:
259
-
260
- - code implemented.
261
- - API/schema reflected.
262
- - worker/runtime path reflected.
263
- - UI/page reflected.
264
- - runtime configured.
265
- - runtime exercised.
266
- - artifact generated.
267
- - artifact accepted by validator.
268
- - API/UI reflects accepted evidence.
269
- - browser or user path verified.
270
- - final gate/check command passed.
271
-
272
- A plan item or AC cannot be complete when its required layer is missing.
273
-
274
- ## Invalid Evidence Rules
275
-
276
- The prompt must reject false proof:
277
-
278
- - viewmodel-only does not prove a real page.
279
- - unit test does not prove real API behavior or latency.
280
- - artifact exists does not prove artifact accepted by validator.
281
- - old result does not prove current state.
282
- - build passes does not prove product acceptance.
283
- - stale, partial, smoke-only, dry-run, sampled-only or research evidence cannot prove full completion.
284
- - unresolved API/UI/data/runtime/test contradictions invalidate completion claims.
285
-
286
- ## Completion State Machine
287
-
288
- Every plan item and AC starts as `unknown / not_run`.
289
-
290
- Only fresh required evidence can mark a plan item or AC complete.
291
-
292
- Any fresh browser / API / runtime / data / test contradiction must downgrade the affected plan item, AC and overall status and must be recorded as invalidating evidence. Do not preserve a previous complete status after contradictory fresh evidence appears.
293
-
294
- ## UI-Facing Gate
295
-
296
- For UI-facing acceptance, the executor must open the real page path and confirm the user-visible state matches the AC. component / viewmodel / mock / unit test evidence is auxiliary unless the full checklist explicitly says otherwise.
297
-
298
- ## Autonomous Progress Protocol
299
-
300
- The Superpowers target prompt must require maximum safe autonomous progress within current platform, repository, tool and user-authorized permission boundaries. Do not ask the user for work the executor can safely discover, run, inspect or verify itself.
301
-
302
- Before treating account, credential or app access as blocked, open the relevant app, browser page, CLI tool or system setting and try existing app sessions, browser cookies, CLI auth, OS credential helpers or other user-authorized local state. If the existing session is absent, expired, permission-denied or requires login/MFA/approval, then pause with the minimal user action list; do not ask the user to send passwords, tokens, cookies or full sensitive fields.
303
-
304
- The Superpowers target prompt must inherit current repository/global `AGENTS.md` or agent-instruction permission policy. Authorized `sudo` / `gsudo` / administrator elevation is not a user blocker; the executor must try it before pausing. Pause only if elevation is unavailable, fails, or requires user/system authorization.
305
-
306
- Pause only for locally unsatisfiable hard blockers such as missing accounts, credentials, production access, paid services, legal/security approval, user-only browser sessions or sensitive fields the executor cannot access safely. When pausing, give the minimum user action list: exact page, system, command or owner to open/contact; exact field or value location; how to redact or avoid sending sensitive values; what the executor will do immediately after receiving the input.
307
-
308
- ## Official Superpowers Binding
309
-
310
- Bind the target prompt to the official Skill names and their documented roles:
311
-
312
- - If the Technical Realization Plan is not bite-sized enough, use `superpowers:writing-plans`.
313
- - Prefer `superpowers:subagent-driven-development` when subagents are available.
314
- - Use `superpowers:executing-plans` when executing a written plan without the same-session subagent workflow.
315
- - Plan or AC behavior gap -> TDD: each behavior gap uses `superpowers:test-driven-development` to write a failing test, observe failure, then implement minimally.
316
- - Before any completion claim, use `superpowers:verification-before-completion` against both `plan-conformance-matrix.*` and `final-acceptance-verdict.*` with fresh evidence, then run `ty-context validate-plan-acceptance tmp/ty-context/plan-acceptance/<plan-slug>`.
317
- - review / finish cannot override the plan-conformance matrix or full checklist; if either gate is unsatisfied, continue implementation or report blockers.
318
-
319
- If Superpowers is missing, install it through the current platform's official Superpowers installation path. If installation is blocked by permissions, network or platform limits, record the blocker in local audit and do not count it as complete.
320
-
321
- ## Local Audit Requirements
322
-
323
- The Superpowers target prompt must require the future executor to update local audit after each round with:
324
-
325
- - candidate status, not final completion.
326
- - Product Context Delta, Technical Context Delta and overall Context Delta decision.
327
- - plan item and AC status.
328
- - current evidence.
329
- - command/result/time and failure reason.
330
- - required test command/result/failure.
331
- - artifact or evidence paths.
332
- - blockers, missing evidence and acceptance impact.
333
- - deferred or narrowed scope with user approval state.
334
- - stale, partial, sampled-only, smoke, dry-run, research or other invalid evidence.
335
-
336
- The local audit is not Context, not proof, not a global task manager, and not a replacement for project tests, CI, review, human acceptance, Task Contract or workflow-contract `plan.md`. It must not contain `overall_status: done`, `status: done` or `final_gate: passed`; use `candidate_status: claims_done_but_unverified` when needed.
337
-
338
- The local audit is process recovery only. It must not contain completion judgment such as accepted, complete, done, final passed or product verified except as invalid evidence being rejected.
339
-
340
- ## Prompt Generation Rules
341
-
342
- - The prompt must visibly output `Superpowers 输入包` for Chinese prompts or `Superpowers input packet` for English prompts.
343
- - The prompt must visibly output `Superpowers 执行绑定` for Chinese prompts or `Superpowers execution binding` for English prompts.
344
- - The prompt must identify Product / Architecture Source, Technical Realization Plan, Acceptance Checklist, local audit, plan-conformance matrix and final verdict paths at the top.
345
- - The prompt must state that the Technical Realization Plan controls plan conformance, the Product / Architecture Source prevents scope shrinkage and the full checklist controls acceptance.
346
- - The prompt must state the Authority Model and that audit/matrix/verdict/validator/auditor artifacts cannot rewrite source, plan or checklist authority.
347
- - The prompt must require Product Context Delta and Technical Context Delta evaluation before implementation.
348
- - The prompt must use parent-level Context Delta plus slice-level new durable fact checks.
349
- - The prompt must state that Evidence Ledger / proof index is optional, but complete rows and ACs require evidence traceability to fresh evidence directly or through optional `evidence_id`.
350
- - The prompt must require the fixed final gate order and rerun `validate-plan-acceptance` if auditor-driven fixes change artifacts.
351
- - The prompt must state the Goal mode completion rule: implementation / execution goals complete only at `product_goal_complete=true`; read-only audit / reporting goals may end at `audit_task_complete` but must still report the acceptance target status.
352
- - The prompt must require the final response to say `Audit workflow completed; acceptance target not complete.` whenever the verdict is not accepted/complete, and must forbid unqualified `Goal achieved` or treating `update_goal(status="complete")` as product acceptance in that case.
353
- - The prompt must preserve hard-blocker semantics: if only locally unsatisfiable hard blockers remain, pause for the user or external owner instead of marking complete.
354
- - The prompt must require maximum safe autonomous progress within current platform, repository, tool and user-authorized permission boundaries and must include the minimum user action list for locally unsatisfiable hard blockers.
355
- - The prompt must say existing app sessions, browser cookies, CLI auth and OS credential helpers are self-service resources: open the relevant app/page/tool/settings first, use existing local auth if present, and pause only after access is actually absent, expired, permission-denied or requires login/MFA/approval.
356
- - The prompt must inherit current repository/global `AGENTS.md` or agent-instruction permission policy. Authorized `sudo` / `gsudo` / administrator elevation is not a user blocker; the executor must try it before pausing. Pause only if elevation is unavailable, fails, or requires user/system authorization.
357
- - The prompt must include the resource lifecycle line: `可多开agent,agent名额不够了就关掉不用的。` or `You may use multiple agents; if agent slots run low, close idle or unnecessary agents.`
358
- - The prompt must fit 3850 characters including line breaks.
359
- - Do not include explanatory preface inside the generated prompt.
360
-
361
- Recommended compact Chinese prompt shape:
362
-
363
- ```text
364
- 产品/架构源: tmp/ty-context/plan-acceptance/<plan-slug>-product-architecture-source.md(原始意图/防 scope shrinkage,非施工图)
365
- 技术实现方案: tmp/ty-context/plan-acceptance/<plan-slug>-technical-realization-plan.md(执行图纸/plan conformance source,非证明)
366
- 验收清单: tmp/ty-context/plan-acceptance/<plan-slug>-acceptance-checklist.md(完整验收标准,final verdict 以它为准)
367
- 执行审计: tmp/ty-context/plan-acceptance/<plan-slug>-local-audit.md(过程日志,非 proof,不能写 done/final_gate passed)
368
- 对图纸矩阵: tmp/ty-context/plan-acceptance/<plan-slug>-plan-conformance-matrix.md/json(先建,边做边更新)
369
- 最终验收: tmp/ty-context/plan-acceptance/<plan-slug>-final-acceptance-verdict.md/json(最后逐 AC 生成)
370
- 可多开agent,agent名额不够了就关掉不用的。
371
- This is not a Superpowers official schema / 不是 Superpowers 官方 schema。
372
- Superpowers 输入包:
373
- - Product/Architecture Source:原始产品/架构意图,防止 scope shrinkage,不是施工图
374
- - Technical Realization Plan:施工图;每个行为 plan item 都要进 matrix
375
- - Acceptance Checklist:最高验收标准;每个 AC 都要进 final verdict
376
- - local audit:只记 progress/candidate status/evidence/blocker/invalidating evidence,不能裁判完成
377
- - Context/tests/core paths:执行前读取,把 plan/AC gap 绑定到测试、API/UI/runtime/browser 证据
378
- 权威:source 管 scope,plan 管施工,checklist 管验收;audit/matrix/verdict/validator/auditor 不能改写它们。Proof index/evidence ledger 文件可选,但 complete 行必须能直接或经 evidence_id 追溯 fresh evidence。
379
- Goal mode:实现/执行目标只在 product_goal_complete=true 时完成;只读审计目标可在 audit_task_complete 时结束,但若 verdict 非 accepted/complete,必须写“Audit workflow completed; acceptance target not complete.”并列数量;不得写 Goal achieved 或把 update_goal complete 当用户目标完成。
380
-
381
- 执行顺序:
382
- 1. 读三份输入和 Context。先写 Task Contract:Product Context Delta none|required;Technical Context Delta none|required;任一 required -> Context Delta required。这不是 validator gate。
383
- 2. 用 Parent Context Delta 统一判断;每个 slice 继承它,只记录 new durable fact yes/no。Context Delta required 时先最小更新 owning project_context/** 或 DESIGN.md;不要把 audit/matrix/verdict/日志/截图/sample evidence 写进 Context。
384
- 3. 检查技术实现方案覆盖产品/架构源关键要求;若只有产品方案没有技术实现方案,停止报告 missing Technical Realization Plan,不现场生成。
385
- 4. 初始化 plan-conformance matrix;计划不够 bite-sized 时用 superpowers:writing-plans。
386
- 5. subagent 支持时优先 superpowers:subagent-driven-development,否则 superpowers:executing-plans。
387
- 6. Plan/AC behavior gap -> superpowers:test-driven-development:先写 failing test 并 observe failure,再最小实现。
388
- 7. 每个实现 slice 后更新 matrix audit。
389
- 8. Candidate done 前跑 Plan Conformance Gate:测试通过不等于按图纸完成;sampled path 不等于 full implementation;每个行为 plan item 必须有 code/API/UI/runtime/test/evidence trace。
390
- 9. 再跑 Acceptance Evidence Gate:按验收清单生成 final verdict;每 AC required proof chain/fresh evidence/missing layers/drift/substitution。current contradiction 高于历史通过记录。
391
- 10. Final gate 固定为 self-evidence -> matrix -> verdict -> validator -> read-only auditor;auditor summary 不是 proof。若审计后改 artifact/evidence,重跑 validator;完成前用 superpowers:verification-before-completion 检查 matrix/verdict,并运行 ty-context validate-plan-acceptance tmp/ty-context/plan-acceptance/<plan-slug>。
392
-
393
- 权限/卡点:在当前平台/仓库/工具/用户已授权权限内最大自主推进;先打开相关 app/浏览器页面/CLI/系统设置,复用已有登录态/授权会话/凭据链;已授权 sudo/gsudo/admin elevation 先尝试。只有实际未登录/会话失效/权限不足/需要 MFA 或人工审批、缺账号/真实环境/敏感字段时才暂停,并给最小用户执行清单(页面/系统、字段位置、脱敏/勿发值、拿到后下一步)。
394
- 禁止完成于:local audit、subagent summary、final card、只改代码/计划、只跑部分测试、旧/部分/抽样证据、缺 required layer、material drift、未批准 sibling substitution、runtime 未演练、artifact 未 accepted、API/UI 未 reflected、未批准 scope narrowing、任何 API/UI/data/runtime/test 矛盾。
395
- ```
396
-
397
- Recommended compact English prompt shape:
398
-
399
- ```text
400
- Product / Architecture Source: tmp/ty-context/plan-acceptance/<plan-slug>-product-architecture-source.md (scope)
401
- Technical Realization Plan: tmp/ty-context/plan-acceptance/<plan-slug>-technical-realization-plan.md (blueprint)
402
- Acceptance Checklist: tmp/ty-context/plan-acceptance/<plan-slug>-acceptance-checklist.md (authority)
403
- Local audit: tmp/ty-context/plan-acceptance/<plan-slug>-local-audit.md (log, not proof)
404
- Plan matrix: tmp/ty-context/plan-acceptance/<plan-slug>-plan-conformance-matrix.md/json (work trace)
405
- Final verdict: tmp/ty-context/plan-acceptance/<plan-slug>-final-acceptance-verdict.md/json (AC gate)
406
- You may use multiple agents; if agent slots run low, close idle or unnecessary agents.
407
- This is not a Superpowers official schema / 不是 Superpowers 官方 schema.
408
- Superpowers input packet:
409
- - Source guards scope; plan controls matrix; checklist controls verdict; audit records progress only.
410
- - Read Context/tests/core paths first; map gaps to test/API/UI/runtime/browser evidence.
411
- Authority: source/plan/checklist own scope/construction/acceptance; audit/matrix/verdict/validator/auditor cannot rewrite them. Proof index optional; complete rows need fresh evidence/evidence_id.
412
- Goal mode: implementation/execution goal complete only when product_goal_complete=true; read-only audit goal may end at audit_task_complete, but if verdict not accepted say "Audit workflow completed; acceptance target not complete." Include counts; no bare "Goal achieved" or update_goal complete as user target.
413
-
414
- Execution order:
415
- 1. Read inputs and Context. Task Contract: Product Context Delta none|required; Technical Context Delta none|required; any required -> Context Delta required. Not a validator gate.
416
- 2. Use Parent Context Delta once; slices inherit it and record new durable fact yes/no. If required, update owning project_context/** or DESIGN.md; never store audit/matrix/verdict/logs/screenshots/sample evidence as Context.
417
- 3. Check Technical Realization Plan covers Product / Architecture Source; if only product plan exists, stop with missing Technical Realization Plan.
418
- 4. Initialize plan-conformance matrix; use superpowers:writing-plans if the plan is not bite-sized.
419
- 5. Prefer superpowers:subagent-driven-development with subagents; otherwise use superpowers:executing-plans.
420
- 6. Plan/AC behavior gap -> superpowers:test-driven-development: write a failing test, observe failure, then implement minimally.
421
- 7. After each slice, update matrix and audit.
422
- 8. Plan Conformance Gate: tests do not prove conformance; sampled path is not full implementation; each behavior item needs code/API/UI/runtime/test/evidence trace.
423
- 9. Acceptance Evidence Gate: checklist controls verdict; each AC records proof chain, fresh evidence, missing layers, drift, substitution. Current contradictions override old passes.
424
- 10. Final gate: self-evidence -> matrix -> verdict -> validator -> read-only auditor. Auditor summary is not proof. Rerun validator after evidence changes; before completion run superpowers:verification-before-completion and ty-context validate-plan-acceptance tmp/ty-context/plan-acceptance/<plan-slug>.
425
-
426
- Autonomy/blockers: self-serve under current permissions. Open app/browser/CLI/settings and reuse sessions/auth/helpers. Try authorized sudo/gsudo/admin. Pause only after missing login, expired session, denied permission, MFA/approval, unavailable env/account or sensitive field; give page/system, field, redaction/do-not-send values, next step.
427
- Never complete on: local audit, summary/final card, code/plan-only, partial tests, stale/partial/sampled evidence, missing layer, material drift, unapproved sibling substitution, unexercised runtime, artifact not accepted, API/UI not reflected, missing validator pass, unapproved scope narrowing or API/UI/data/runtime/test contradiction.
428
- ```
429
-
430
- Before final response, check the prompt length. If it exceeds 3850 characters, tighten wording while preserving paths, input roles, official Superpowers skill names, Product Context Delta, Technical Context Delta, plan-conformance matrix, final verdict, state machine, UI gate, blockers and invalid evidence.
431
-
432
- ## Final Response Requirements
433
-
434
- When successful, return:
435
-
436
- - The Product / Architecture Source path.
437
- - The Technical Realization Plan path.
438
- - The full checklist path.
439
- - The local audit path.
440
- - The plan-conformance matrix path.
441
- - The final acceptance verdict path.
442
- - Whether required input was complete.
443
- - The generated prompt's Goal mode completion rule for implementation / execution goals, and required final status wording for non-accepted read-only audit results: `Audit workflow completed; acceptance target not complete.`
444
- - The paste-ready Superpowers target-mode prompt in a code block.
445
-
446
- When blocked, return:
447
-
448
- - Missing Fields Report.
449
- - `missing_section`.
450
- - `missing_required_fields`.
451
- - `why_blocking`.
452
- - `cannot_infer_policy`.
453
- - `required_next_input`.
454
- - `suggested_upstream_action`.
455
- - A clear statement that no Superpowers target-mode prompt was generated.
456
-
457
- Do not claim any plan item or AC has passed unless the user explicitly asked for current completion audit and current evidence was inspected.
458
-
459
- ## Forbidden Behaviors
460
-
461
- Do not generate, derive, or infer the Technical Realization Plan.
462
-
463
- Do not generate, derive, rewrite, strengthen, or repair the full checklist.
464
-
465
- Do not execute the generated prompt.
466
-
467
- Do not mark any goal complete.
468
-
469
- Do not hide missing source files, ambiguous scope, weak evidence, implementation drift or blockers.
470
-
471
- Do not include business-domain logic, concrete provider names, API names, UI names, artifact schemas or one-off project details in this package-managed Skill.
1
+ ---
2
+ name: superpowers-long-task
3
+ description: Use when directly invoked for Superpowers long-running task target prompt preparation.
4
+ ---
5
+
6
+ # Superpowers Long Task Skill
7
+
8
+ ## Package-Managed Boundary
9
+
10
+ This Skill is generated by `ty-context sync` and owned by the Harness package. Do not edit the generated `superpowers-long-task` Skill directly in a consumer project.
11
+
12
+ This is Tiny Context's adapter for feeding a recommended three-input long-task packet into the external Superpowers workflow. It is aligned to the official Superpowers skills, while remaining a Tiny Context-owned adapter rather than an upstream-owned schema. It makes the target-mode prompt explicit enough that the official Superpowers skills can do their intended work without losing Tiny Context context-delta, plan-conformance and acceptance authority.
13
+
14
+ ## Purpose
15
+
16
+ The extra Tiny Context gates exist because Superpowers alone can still drift under long-running execution pressure. Superpowers strengthens execution discipline, but it does not by itself preserve source authority, prevent scope shrinkage, prove full conformance to the Technical Realization Plan, or enforce AC-by-AC evidence against the Acceptance Checklist.
17
+
18
+ Consumes three existing upstream inputs and emits a paste-ready Superpowers target-mode prompt:
19
+
20
+ - Product / Architecture Source: original intent source for scope, product logic, surface responsibility and durable architecture intent.
21
+ - Technical Realization Plan: the execution blueprint and plan-conformance source.
22
+ - Acceptance Checklist: the acceptance authority and final-verdict source.
23
+
24
+ Use this Skill only after all three inputs already exist or are pasted in full. The Technical Realization Plan must already be equivalent to a Superpowers-ready Markdown implementation plan; when it satisfies the required input fields, this Skill skips plan generation and produces the execution binding directly. Two-document compatibility is allowed only when the first document explicitly contains both Product / Architecture Source and Technical Realization Plan sections; otherwise stop for a missing Technical Realization Plan. Do not generate, derive, or infer the Technical Realization Plan. Do not generate, derive, rewrite, strengthen, or repair the full checklist in this Skill. If plan items or ACs are too vague to trace, stop and ask for the missing fields. If only generic conformance or verdict rules are missing, inject this Skill's default rules into the generated prompt.
25
+
26
+ This Skill does not perform task-complexity routing. Direct invocation means the user or upstream process has already selected Superpowers long-task execution. Ordinary checklist preparation, non-Superpowers target prompts or incomplete upstream packets should be handled before this Skill, normally with `/normal-long-task` or a revised upstream packet.
27
+
28
+ ## Direct Invocation
29
+
30
+ Use this Skill through explicit invocation:
31
+
32
+ ```text
33
+ /superpowers-long-task
34
+ ```
35
+
36
+ Do not rely on broad automatic keyword routing. `/normal-long-task` remains useful for ordinary acceptance preparation, but this Skill does not require it when the product/architecture source, technical realization plan and acceptance checklist are already supplied.
37
+
38
+ ## Use Cases
39
+
40
+ Use this Skill when a three-input long-task packet needs:
41
+
42
+ - Superpowers target-mode prompt.
43
+ - Superpowers goal-mode prompt.
44
+ - Superpowers 目标模式文本.
45
+ - Superpowers-compatible Codex target prompt.
46
+ - Superpowers execution binding with Context Delta, plan-conformance and acceptance-evidence gates.
47
+
48
+ Do not trigger merely because a plan mentions TDD or subagents. The user must ask for a Superpowers target/goal prompt or equivalent execution adapter.
49
+
50
+ ## Required Three-Input Packet
51
+
52
+ The input must fully expose these fields:
53
+
54
+ - Product / Architecture Source path or pasted text.
55
+ - original requirement source or original plan summary.
56
+ - durable product intent when applicable: product capability, user flow, business state/rule, page/surface responsibility, information architecture, product ownership, status meaning, operation boundary or acceptance semantics.
57
+ - durable architecture intent when applicable: module boundary, dependency direction, API/schema/data/event contract, worker/runtime/state-machine semantics, verification/deployment path or stable technical tradeoff.
58
+ - Technical Realization Plan path or pasted text.
59
+ - traceable plan items or sections that affect behavior and can be executed like a Superpowers Markdown implementation plan.
60
+ - expected implementation surfaces when applicable: code, API/schema, UI/page, worker/runtime, artifact, data, tests.
61
+ - required code/API/schema/UI/worker/runtime/data/test/evidence mapping when applicable.
62
+ - full-scope versus sample/optional boundaries.
63
+ - explicitly non-completing shortcuts, such as local-only enhancement, old page continuing to own a moved responsibility, sampled path, plan-only work or test-only patch.
64
+ - full acceptance checklist path or pasted text.
65
+ - acceptance items or AC IDs.
66
+ - required evidence and verification method per AC.
67
+ - required tests or explicit no-test scope.
68
+ - valid and invalid evidence rules.
69
+ - Completion State Machine rules.
70
+ - UI-Facing Gate rules when any AC touches UI.
71
+ - hard blockers or an explicit no-blocker statement.
72
+
73
+ If any of these are missing required fields, stop. Do not generate the Superpowers target-mode prompt. Report whether each missing field belongs in Product / Architecture Source, Technical Realization Plan, Acceptance Checklist, blocker section or Context reference. If the user supplied only a product/architecture source plus checklist, report missing Technical Realization Plan.
74
+
75
+ When blocked by missing input, return a structured Missing Fields Report with:
76
+
77
+ - `missing_section`.
78
+ - `missing_required_fields`.
79
+ - `why_blocking`.
80
+ - `cannot_infer_policy`.
81
+ - `required_next_input`.
82
+ - `suggested_upstream_action`.
83
+
84
+ The report must state that this Skill cannot infer the execution blueprint from Product / Architecture Source and cannot repair the checklist. It may recommend supplying a complete Product / Architecture Source, Technical Realization Plan or Acceptance Checklist packet before Superpowers execution when the upstream packet is not ready.
85
+
86
+ ## Source Roles
87
+
88
+ - Product / Architecture Source prevents scope shrinkage and drives Product Context Delta / architecture-intent checks; it is not the code construction plan.
89
+ - Technical Realization Plan is the execution blueprint and the source for `plan-conformance-matrix.*`; it is not proof.
90
+ - Acceptance Checklist is the completion authority and the source for `final-acceptance-verdict.*`.
91
+ - local audit records progress, candidate status, evidence, blockers and invalidating evidence only; it is not proof and must not mark final completion.
92
+ - relevant Context remains the durable repo intent and boundary source.
93
+ - required tests / core paths bind plan and AC gaps to executable verification.
94
+
95
+ Do not let a compact target prompt override the product/architecture source, technical realization plan or full checklist. The compact prompt is direction, priority and recovery navigation only. The technical realization plan controls plan conformance; the product/architecture source prevents scope shrinkage; the full checklist controls acceptance.
96
+
97
+ ## Authority Model
98
+
99
+ - Product / Architecture Source owns intent, scope, non-goals, product/architecture boundaries and acceptance semantics.
100
+ - Technical Realization Plan owns plan items, execution blueprint, owner/forbidden surfaces, implementation paths and plan-conformance expectations.
101
+ - Acceptance Checklist owns ACs, completion semantics, required proof layers, invalid evidence rules and final acceptance state.
102
+ - local audit, plan-conformance matrix, final acceptance verdict, validator output, optional proof index and auditor report are execution/evidence artifacts. They cannot narrow, rewrite or replace the upstream sources.
103
+ - When sources conflict, stop or report the conflict instead of letting a downstream artifact silently change scope, plan or acceptance.
104
+ - Tiny Context additions may wrap Superpowers with authority, conformance and acceptance gates, but they must not redefine, duplicate or fork official Superpowers execution mechanics. If a future change would make a Tiny Context-added step conflict with, duplicate or override an official Superpowers responsibility, stop and surface the boundary conflict instead of silently merging the workflows.
105
+
106
+ ## Context Delta Assessment
107
+
108
+ The prompt must require the future executor to evaluate Context before implementation using:
109
+
110
+ ```text
111
+ Product Context Delta: none|required
112
+ Technical Context Delta: none|required
113
+ Context Delta: none|required
114
+ ```
115
+
116
+ Any required sub-delta makes overall Context Delta required. This is prompt-level workflow discipline, not a validator gate, not a machine-enforced gate, not a phase gate and not a new document chain.
117
+
118
+ `Product Context Delta: required` applies when the product/architecture source changes durable product facts such as product capability, user flow, business state/rule, page or surface responsibility, main/drilldown ownership, information architecture, user-visible terminology, status meaning, operation boundary, product/domain ownership or acceptance semantics.
119
+
120
+ `Technical Context Delta: required` applies when the product/architecture source or Technical Realization Plan changes durable technical facts such as API/schema/event/data contract, module ownership, dependency direction, worker/runtime/state-machine semantics, data model, persistence, scheduling, failure/retry/recovery semantics, verification/deployment/bootstrap path or stable technical tradeoff.
121
+
122
+ When overall `Context Delta: required`, the executor must update the smallest owning `project_context/**` or `DESIGN.md` fact before implementation continues. Use existing roles only: `area`, `subdomain`, `contract`, `foundation`, `verification`, `deployment`, `implementation-index` and `decision-rationale`. Do not write local audit, plan-conformance matrix, final acceptance verdict, temporary plan, sampled evidence, one-off logs, raw outputs, screenshots or PR notes into Context.
123
+
124
+ For Superpowers execution, the generated prompt should use a parent/slice pattern:
125
+
126
+ - Parent Context Delta: evaluate Product Context Delta, Technical Context Delta, overall Context Delta, owning Context files and whether required Context was updated before implementation.
127
+ - Slice Context Delta: each implementation slice inherits the parent decision and only records whether it discovered a new durable fact.
128
+ - If a slice discovers a new durable product or technical fact, it must identify the owning Context and update it before continuing.
129
+ - Slice-level `none` cannot override a parent-level `required` decision.
130
+
131
+ ## Plan Conformance Gate
132
+
133
+ The prompt must require the future executor to create or initialize `tmp/ty-context/plan-acceptance/<plan-slug>-plan-conformance-matrix.md` and `.json` before substantial implementation, then update it after each meaningful implementation slice.
134
+
135
+ Each behavior-affecting Technical Realization Plan item must have a trace entry with:
136
+
137
+ - plan item id and plan requirement.
138
+ - acceptance ids covered by the plan item when applicable.
139
+ - expected surfaces.
140
+ - implemented paths.
141
+ - missing paths.
142
+ - tests.
143
+ - runtime or artifact evidence.
144
+ - scope assessment.
145
+ - status.
146
+ - drift.
147
+ - required proof layers, satisfied proof layers and missing required layers when the plan/checklist requires layered evidence.
148
+ - substitute or sibling evidence use when any similar execution path, negative case, screenshot or artifact could be confused with the required evidence.
149
+ - Context fact refs when Context Delta is required.
150
+ - For Product Surface, IA or architecture-migration items: conformance type, owner surface, required user paths, forbidden primary surfaces, real page evidence, negative surface checks and default visibility requirement.
151
+
152
+ Allowed plan-conformance statuses:
153
+
154
+ - `complete`
155
+ - `partial`
156
+ - `sampled_only`
157
+ - `not_implemented`
158
+ - `blocked`
159
+ - `scope_changed_requires_user_approval`
160
+ - `contradicted_by_current_state`
161
+ - `out_of_scope_NA`
162
+
163
+ Hard rules:
164
+
165
+ - Passing tests does not imply plan conformance.
166
+ - A sampled implementation path does not imply full plan implementation.
167
+ - A local audit cannot narrow plan scope or mark completion.
168
+ - Scope correction requires explicit user approval or a revised product/architecture source, Technical Realization Plan and checklist.
169
+ - Every behavior-affecting plan section must have an implementation trace entry.
170
+ - Product Surface, IA or architecture-migration rows cannot be complete without owner surface, required user paths, real page evidence, negative surface checks for forbidden primary surfaces and Context fact refs when Context Delta is required.
171
+ - A complete row cannot have unresolved `missing_required_layers`, material or critical `drift_severity`, unapproved `sibling_substitution_used`, summary-only evidence or blocking auditor findings.
172
+ - Any `partial`, `sampled_only`, `not_implemented`, unresolved blocker, unapproved scope change or current contradiction prevents overall done.
173
+
174
+ ## Acceptance Evidence Gate
175
+
176
+ The prompt must require the future executor to generate `tmp/ty-context/plan-acceptance/<plan-slug>-final-acceptance-verdict.md` and `.json` only at the final gate, after Context Delta handling, Plan Conformance Gate and current evidence checks.
177
+
178
+ Each AC verdict entry must include:
179
+
180
+ - AC id or acceptance item.
181
+ - related plan item ids when applicable.
182
+ - status.
183
+ - required evidence.
184
+ - required proof chain when the checklist or plan requires multiple evidence layers.
185
+ - fresh evidence.
186
+ - missing evidence.
187
+ - missing required layers.
188
+ - drift severity.
189
+ - sibling substitution used / approval source.
190
+ - auditor status and findings when an auditor subagent was available.
191
+ - contradictions.
192
+ - decision.
193
+
194
+ Allowed AC statuses:
195
+
196
+ - `complete`
197
+ - `partial`
198
+ - `blocked`
199
+ - `not_run`
200
+ - `invalidated`
201
+ - `out_of_scope_NA`
202
+
203
+ Hard rules:
204
+
205
+ - Final completion requires an AC-by-AC final acceptance verdict.
206
+ - Before any completion claim, run `ty-context validate-plan-acceptance tmp/ty-context/plan-acceptance/<plan-slug>`; failure prevents final complete and must produce partial / blocker / missing-evidence output.
207
+ - `validate-plan-acceptance` rejects contradictory matrix/verdict JSON, weak-proof complete rows, missing cross-references and declared surface/architecture binding gaps; it checks artifact consistency and references, not product quality.
208
+ - Current API/UI/runtime/data/test contradictions override historical passing evidence.
209
+ - local audit, subagent summaries, final result card text, passing test logs, stale artifacts, partial smoke, dry-run or sampled paths cannot prove completion by themselves.
210
+ - Any current contradiction downgrades the affected AC and overall status.
211
+ - Scope narrowing in audit does not modify acceptance unless the user approved a revised source/plan/checklist.
212
+ - `out_of_scope_NA` requires explicit reason and source reference; arbitrary prose cannot waive missing evidence.
213
+ - Complete AC rows cannot have unresolved `missing_required_layers`, material or critical `drift_severity`, unapproved `sibling_substitution_used`, blocking `auditor_status` or only self-certifying evidence such as local audit, matrix/verdict text, subagent summary, final card or validator pass.
214
+
215
+ ## External Reviewer Evidence Gate
216
+
217
+ The final verdict is not completion proof unless every complete AC can be independently reviewed from fresh command, API, UI, runtime, artifact, browser or test evidence. Evidence index, matrix rows, local audit, validator pass and summaries can point to evidence, but cannot replace evidence.
218
+
219
+ For every AC whose checklist implies multiple required layers, the final verdict must record `required_proof_chain`, `fresh_evidence`, `missing_required_layers`, `drift_severity`, `sibling_substitution_used`, `auditor_status` and `auditor_findings` when applicable. These are generic evidence protocol fields; concrete business layers must come from the Acceptance Checklist, Product / Architecture Source, Technical Realization Plan or project-local Context/Skills.
220
+
221
+ Evidence Ledger / proof index is optional execution indexing, not a fourth input, not durable Context and not required as a separate file. Complete plan-conformance rows and complete AC verdicts must still be evidence-traceable: cite fresh, reviewable evidence directly in the row or through an optional `evidence_id` that points to command, API, UI, runtime, artifact, browser or test evidence with enough freshness context for a reviewer to reconstruct the proof chain.
222
+
223
+ ## Evidence Manifest And Slice Batching
224
+
225
+ For non-trivial execution slices, the prompt should recommend a rolling optional evidence manifest at `tmp/ty-context/plan-acceptance/<plan-slug>-evidence-manifest.md/json`. The manifest is not a fourth input, not durable Context, not proof by itself and not required by `validate-plan-acceptance`; it is a slice-level source for synchronizing matrix, verdict and audit updates with less stale wording.
226
+
227
+ Each manifest entry should include `evidence_id`, `slice_id`, `slice_goal`, `missing_layer_classes`, `touched_plan_item_ids`, `touched_ac_ids`, `commands`, `artifacts`, `runtime_or_browser_evidence`, `proves`, `explicitly_does_not_prove`, `closed_missing_layers`, `remaining_missing_layers`, `cleanup_status`, `redaction_security_status` and `freshness`.
228
+
229
+ The manifest must not contain secrets, raw credentials, tokens, cookies or long raw payloads. Record redacted paths, command identities, evidence ids, counts and short summaries instead.
230
+
231
+ Default slice sizing: group 2-4 strongly related missing layers that share the same AC, runtime scenario, proof environment or verification path. Single-gap slices are reserved for blockers, contradictions or tiny metadata cleanup. Before choosing a slice, classify missing layers as functional gap, proof gap, stale wording/artifact sync, upstream blocker, live DB/runtime proof, Browser/UI proof, security/redaction proof or all-provider/all-runner coverage.
232
+
233
+ After each slice, update matrix and local audit from the manifest. Update verdict evidence/missing-layer fields conservatively, but do not mark ACs complete before the final gate. Reuse DB/API/Browser environments for related slices only with unique proof prefixes and a final cleanup count/assertion.
234
+
235
+ Run a stale/overclaim scan over the evidence manifest, matrix, verdict and audit after synchronization. Remove leftover closed gaps and reject unsafe claims such as `accepted`, `complete`, `final passed`, `product_goal_complete=true`, unapproved `scope narrowed` or unapproved sibling substitution unless the checklist and final gate justify them.
236
+
237
+ ## Gate Cadence And Progress Accounting
238
+
239
+ The generated prompt must use a tiered cadence instead of running the full final gate after every slice:
240
+
241
+ - Slice Gate: after each implementation slice, sync the evidence manifest when used, matrix, local audit and conservative verdict evidence/missing-layer fields; run only targeted tests or probes needed for that slice; run stale/overclaim cleanup; do not run the full final gate after every slice.
242
+ - Epoch Gate: after a cluster of related slices, such as a provider/browser/runtime/security epoch, batch shared DB/API/Browser/proof-environment cleanup and rerun the higher-value cross-slice tests, validators or smoke checks for that cluster.
243
+ - Final Gate: after all required plan items and AC proof layers are ready, run the fixed final gate order, including `superpowers:verification-before-completion`, `ty-context validate-plan-acceptance`, read-only auditor when available, final stale/overclaim scan and completion wording.
244
+
245
+ The generated prompt must require Progress Accounting after each Slice Gate, Epoch Gate and Final Gate. Track four metrics separately:
246
+
247
+ - AC acceptance completion: AC rows that are `complete` or sourced `out_of_scope_NA` versus acceptance-required AC rows.
248
+ - engineering implementation progress: plan-conformance rows with implemented paths/tests/evidence versus behavior-affecting plan rows.
249
+ - runtime/proof progress: required proof layers by status, not just code landed.
250
+ - workflow overhead: time, artifacts, gate loops, stale-sync cleanup and review burden spent on workflow rather than product proof.
251
+
252
+ Use a lightweight progress ledger at `tmp/ty-context/plan-acceptance/<plan-slug>-progress-ledger.md/json` when the task spans multiple slices or agents. The progress ledger is not Context, not proof and not a fourth input; it records current counts, gate cadence, next high-value clusters and stale-state cleanup so the executor does not rerun the full final gate after every slice.
253
+
254
+ Every non-trivial slice should declare an artifact budget: expected files/manifest rows/screenshots/log summaries to create or update, maximum raw-output retention, cleanup expectations and which artifacts are safe to sync into verdict rows. Excess artifact growth or repeated stale-sync cleanup triggers workflow overhead backpressure: batch the next proof-environment run, merge small stale-only slices, prune obsolete temporary notes and prefer the next proof that closes the most AC/proof-layer gaps.
255
+
256
+ Proof-layer milestones should use only these statuses: `not_started`, `implemented_no_proof`, `proof_partial`, `proof_ready`, `complete`, `blocked` and `out_of_scope_NA`. Milestones are progress visibility, not acceptance by themselves. The prompt should ask for Next 3-5 high-value clusters after each epoch: choose clusters that close the most blocking AC/proof layers with the least new workflow overhead.
257
+
258
+ When final-verdict Markdown includes generated active counts, wrap them exactly in:
259
+
260
+ ```text
261
+ <!-- generated:active-counts:start -->
262
+ complete_count: <n>
263
+ partial_count: <n>
264
+ acceptance_required_count: <n>
265
+ missing_layer_count: <n>
266
+ <!-- generated:active-counts:end -->
267
+ ```
268
+
269
+ Active generated counts must be regenerated from the current verdict, not hand-maintained from stale prose.
270
+
271
+ ## Drift-to-Status
272
+
273
+ Any plan item or AC with unresolved missing required layers, material / critical drift or a current API / UI / runtime / data / test contradiction cannot be `complete`. It must be `partial`, `blocked`, `invalidated` or `out_of_scope_NA` with explicit source reference.
274
+
275
+ ## No Sibling Substitution
276
+
277
+ The same execution path, negative case, screenshot or artifact class cannot substitute for the required one unless the checklist explicitly allows that substitution or marks the required layer `out_of_scope_NA`. Similar evidence is auxiliary only.
278
+
279
+ ## Independent Reviewer Gate
280
+
281
+ When subagents are available, add a read-only auditor after executor self-evidence and `validate-plan-acceptance`. The auditor is a gap detector, not a proof source: it must not edit code, repair artifacts or treat local audit, subagent summary, matrix/verdict text, validator pass or final card as proof. It reconstructs each AC proof chain from source/plan/checklist, checks freshness and raw evidence, rejects sibling substitution and returns `auditor_status` plus findings. Any `partial`, `blocked` or `invalidated` auditor result downgrades the affected AC unless fresh evidence closes the gap.
282
+
283
+ Use a fixed auditor checklist: source/plan/checklist consistency, closed gaps have fresh evidence, active matrix/verdict wording removed closed missing layers, remaining blockers are preserved, live evidence is fresh and not dry-run/sample substitution, UI proof uses real owner surface evidence, no unapproved sibling substitution or scope narrowing, no overclaim and final status matches the proof chain.
284
+
285
+ Final gate order is fixed:
286
+
287
+ 1. update evidence manifest when used.
288
+ 2. sync plan-conformance matrix, final-acceptance verdict and local audit.
289
+ 3. run `superpowers:verification-before-completion` against matrix and verdict.
290
+ 4. run `ty-context validate-plan-acceptance`.
291
+ 5. run read-only auditor gap review when subagents are available.
292
+ 6. if auditor findings change artifacts or evidence, fix the gap and rerun `ty-context validate-plan-acceptance`.
293
+ 7. run a final lightweight stale/overclaim scan.
294
+ 8. make a final completion claim only when self-evidence, validator consistency and auditor review have no blocking conflict.
295
+
296
+ ## Goal And Acceptance Wording
297
+
298
+ The Superpowers target prompt must keep three completion concepts separate:
299
+
300
+ - `audit_task_complete`: the read-only audit, final-gate workflow or artifact-production task finished.
301
+ - `acceptance_target_status`: the final verdict outcome for the checked plan or product target.
302
+ - `product_goal_complete`: the checked plan or product target is accepted as complete.
303
+
304
+ `product_goal_complete` may be true only when the final verdict overall status is `accepted` or `complete`, all required ACs are `complete` or explicit sourced `out_of_scope_NA`, `ty-context validate-plan-acceptance` passes, and any auditor has no blocking finding.
305
+
306
+ When the generated prompt is used as an implementation or execution Goal mode objective, the active Codex goal is complete only when `product_goal_complete=true`. A non-accepted `acceptance_target_status` means continue implementation or report blockers / missing evidence; do not close the implementation goal as complete.
307
+
308
+ A read-only audit / reporting Goal mode objective is different: when the explicit goal is only to produce an audit and verdict, `audit_task_complete` may complete that meta-goal even when `product_goal_complete=false`. In that case, if `acceptance_target_status` is `partial`, `blocked`, `invalidated`, `not_run`, `partial_not_accepted_as_complete_platform` or any other non-accepted status, the final response must say `Audit workflow completed; acceptance target not complete.` It should include complete / partial / blocked / not_run / invalidated counts when available. Do not write an unqualified `Goal achieved` and do not describe `update_goal(status="complete")` as user-target or product-goal completion in that case.
309
+
310
+ ## Evidence Layer Separation
311
+
312
+ Keep these layers separate in the prompt when relevant:
313
+
314
+ - code implemented.
315
+ - API/schema reflected.
316
+ - worker/runtime path reflected.
317
+ - UI/page reflected.
318
+ - runtime configured.
319
+ - runtime exercised.
320
+ - artifact generated.
321
+ - artifact accepted by validator.
322
+ - API/UI reflects accepted evidence.
323
+ - browser or user path verified.
324
+ - final gate/check command passed.
325
+
326
+ A plan item or AC cannot be complete when its required layer is missing.
327
+
328
+ ## Invalid Evidence Rules
329
+
330
+ The prompt must reject false proof:
331
+
332
+ - viewmodel-only does not prove a real page.
333
+ - unit test does not prove real API behavior or latency.
334
+ - artifact exists does not prove artifact accepted by validator.
335
+ - old result does not prove current state.
336
+ - build passes does not prove product acceptance.
337
+ - stale, partial, smoke-only, dry-run, sampled-only or research evidence cannot prove full completion.
338
+ - unresolved API/UI/data/runtime/test contradictions invalidate completion claims.
339
+
340
+ ## Completion State Machine
341
+
342
+ Every plan item and AC starts as `unknown / not_run`.
343
+
344
+ Only fresh required evidence can mark a plan item or AC complete.
345
+
346
+ Any fresh browser / API / runtime / data / test contradiction must downgrade the affected plan item, AC and overall status and must be recorded as invalidating evidence. Do not preserve a previous complete status after contradictory fresh evidence appears.
347
+
348
+ ## UI-Facing Gate
349
+
350
+ For UI-facing acceptance, the executor must open the real page path and confirm the user-visible state matches the AC. component / viewmodel / mock / unit test evidence is auxiliary unless the full checklist explicitly says otherwise.
351
+
352
+ ## Autonomous Progress Protocol
353
+
354
+ The Superpowers target prompt must require maximum safe autonomous progress within current platform, repository, tool and user-authorized permission boundaries. Do not ask the user for work the executor can safely discover, run, inspect or verify itself.
355
+
356
+ Before treating account, credential or app access as blocked, open the relevant app, browser page, CLI tool or system setting and try existing app sessions, browser cookies, CLI auth, OS credential helpers or other user-authorized local state. If the existing session is absent, expired, permission-denied or requires login/MFA/approval, then pause with the minimal user action list; do not ask the user to send passwords, tokens, cookies or full sensitive fields.
357
+
358
+ The Superpowers target prompt must inherit current repository/global `AGENTS.md` or agent-instruction permission policy. Authorized `sudo` / `gsudo` / administrator elevation is not a user blocker; the executor must try it before pausing. Pause only if elevation is unavailable, fails, or requires user/system authorization.
359
+
360
+ Pause only for locally unsatisfiable hard blockers such as missing accounts, credentials, production access, paid services, legal/security approval, user-only browser sessions or sensitive fields the executor cannot access safely. When pausing, give the minimum user action list: exact page, system, command or owner to open/contact; exact field or value location; how to redact or avoid sending sensitive values; what the executor will do immediately after receiving the input.
361
+
362
+ ## Official Superpowers Binding
363
+
364
+ Bind the target prompt to the official Skill names and their documented roles:
365
+
366
+ - Prefer `superpowers:subagent-driven-development` when subagents are available.
367
+ - Use `superpowers:executing-plans` when executing a written plan without the same-session subagent workflow.
368
+ - Plan or AC behavior gap -> TDD: each behavior gap uses `superpowers:test-driven-development` to write a failing test, observe failure, then implement minimally.
369
+ - Before any completion claim, use `superpowers:verification-before-completion` against both `plan-conformance-matrix.*` and `final-acceptance-verdict.*` with fresh evidence, then run `ty-context validate-plan-acceptance tmp/ty-context/plan-acceptance/<plan-slug>`.
370
+ - review / finish cannot override the plan-conformance matrix or full checklist; if either gate is unsatisfied, continue implementation or report blockers.
371
+ - Superpowers review and verification remain useful execution checks, but they cannot override Tiny Context gates: passing Superpowers review does not by itself prove plan conformance or checklist acceptance.
372
+
373
+ If Superpowers is missing, install it through the current platform's official Superpowers installation path. If installation is blocked by permissions, network or platform limits, record the blocker in local audit and do not count it as complete.
374
+
375
+ ## Local Audit Requirements
376
+
377
+ The Superpowers target prompt must require the future executor to update local audit after each round with:
378
+
379
+ - candidate status, not final completion.
380
+ - Product Context Delta, Technical Context Delta and overall Context Delta decision.
381
+ - plan item and AC status.
382
+ - current evidence.
383
+ - command/result/time and failure reason.
384
+ - required test command/result/failure.
385
+ - artifact or evidence paths.
386
+ - blockers, missing evidence and acceptance impact.
387
+ - deferred or narrowed scope with user approval state.
388
+ - stale, partial, sampled-only, smoke, dry-run, research or other invalid evidence.
389
+
390
+ The local audit is not Context, not proof, not a global task manager, and not a replacement for project tests, CI, review, human acceptance, Task Contract or workflow-contract `plan.md`. It must not contain `overall_status: done`, `status: done` or `final_gate: passed`; use `candidate_status: claims_done_but_unverified` when needed.
391
+
392
+ The local audit is process recovery only. It must not contain completion judgment such as accepted, complete, done, final passed or product verified except as invalid evidence being rejected.
393
+
394
+ ## Prompt Generation Rules
395
+
396
+ - The prompt must visibly output `Superpowers 输入包` for Chinese prompts or `Superpowers input packet` for English prompts.
397
+ - The prompt must visibly output `Superpowers 执行绑定` for Chinese prompts or `Superpowers execution binding` for English prompts.
398
+ - The prompt must state that this is a Tiny Context adapter for Superpowers workflows, aligned to the official Superpowers skills, not an upstream-owned schema.
399
+ - The prompt must state that Tiny Context gates wrap Superpowers for source authority, conformance and acceptance, but do not redefine or fork Superpowers execution mechanics.
400
+ - The prompt must identify Product / Architecture Source, Technical Realization Plan, Acceptance Checklist, local audit, plan-conformance matrix and final verdict paths at the top.
401
+ - The prompt must state that the Technical Realization Plan controls plan conformance, the Product / Architecture Source prevents scope shrinkage and the full checklist controls acceptance.
402
+ - The prompt must state the Authority Model and that audit/matrix/verdict/validator/auditor artifacts cannot rewrite source, plan or checklist authority.
403
+ - The prompt must require Product Context Delta and Technical Context Delta evaluation before implementation.
404
+ - The prompt must use parent-level Context Delta plus slice-level new durable fact checks.
405
+ - The prompt must state that Evidence Ledger / proof index is optional, but complete rows and ACs require evidence traceability to fresh evidence directly or through optional `evidence_id`.
406
+ - The prompt must recommend optional `evidence-manifest.md/json` for non-trivial slices, while stating it is not a fourth input, not durable Context, not proof and not required by `validate-plan-acceptance`.
407
+ - The prompt must forbid secrets, raw credentials, tokens, cookies and long raw payloads in evidence manifests.
408
+ - The prompt must prefer 2-4 strongly related missing layers per slice, require missing-layer classification, manifest-driven matrix/audit synchronization, conservative verdict updates and no AC completion before the final gate.
409
+ - The prompt must include Slice Gate, Epoch Gate and Final Gate cadence; it must say not to run the full final gate after every slice.
410
+ - The prompt must include Progress Accounting for AC acceptance completion, engineering implementation progress, runtime/proof progress and workflow overhead.
411
+ - The prompt must include the progress-ledger.md/json path, artifact budget, proof-layer milestone statuses, workflow overhead backpressure and Next 3-5 high-value clusters.
412
+ - The prompt must mention provider/browser/runtime/security epoch batching and generated active-count markers for final-verdict Markdown.
413
+ - The prompt must include stale/overclaim scan, related-runtime reuse with unique proof prefixes and cleanup count/assertion, and the fixed auditor checklist.
414
+ - The prompt must require the fixed final gate order and rerun `validate-plan-acceptance` if auditor-driven fixes change artifacts.
415
+ - The prompt must state the Goal mode completion rule: implementation / execution goals complete only at `product_goal_complete=true`; read-only audit / reporting goals may end at `audit_task_complete` but must still report the acceptance target status.
416
+ - The prompt must require the final response to say `Audit workflow completed; acceptance target not complete.` whenever the verdict is not accepted/complete, and must forbid unqualified `Goal achieved` or treating `update_goal(status="complete")` as product acceptance in that case.
417
+ - The prompt must preserve hard-blocker semantics: if only locally unsatisfiable hard blockers remain, pause for the user or external owner instead of marking complete.
418
+ - The prompt must require maximum safe autonomous progress within current platform, repository, tool and user-authorized permission boundaries and must include the minimum user action list for locally unsatisfiable hard blockers.
419
+ - The prompt must say existing app sessions, browser cookies, CLI auth and OS credential helpers are self-service resources: open the relevant app/page/tool/settings first, use existing local auth if present, and pause only after access is actually absent, expired, permission-denied or requires login/MFA/approval.
420
+ - The prompt must inherit current repository/global `AGENTS.md` or agent-instruction permission policy. Authorized `sudo` / `gsudo` / administrator elevation is not a user blocker; the executor must try it before pausing. Pause only if elevation is unavailable, fails, or requires user/system authorization.
421
+ - The prompt must include the resource lifecycle line: `可多开agent,agent名额不够了就关掉不用的。` or `You may use multiple agents; if agent slots run low, close idle or unnecessary agents.`
422
+ - The prompt must fit 3850 characters including line breaks.
423
+ - Do not include explanatory preface inside the generated prompt.
424
+
425
+ Recommended compact Chinese prompt shape:
426
+
427
+ ```text
428
+ 产品/架构源: tmp/ty-context/plan-acceptance/<plan-slug>-product-architecture-source.md(原始意图/防 scope shrinkage,非施工图)
429
+ 技术实现方案: tmp/ty-context/plan-acceptance/<plan-slug>-technical-realization-plan.md(执行图纸/plan conformance source,非证明)
430
+ 验收清单: tmp/ty-context/plan-acceptance/<plan-slug>-acceptance-checklist.md(完整验收标准,final verdict 以它为准)
431
+ 执行审计: tmp/ty-context/plan-acceptance/<plan-slug>-local-audit.md(过程日志,非 proof,不能写 done/final_gate passed)
432
+ 对图纸矩阵: tmp/ty-context/plan-acceptance/<plan-slug>-plan-conformance-matrix.md/json(先建,边做边更新)
433
+ 最终验收: tmp/ty-context/plan-acceptance/<plan-slug>-final-acceptance-verdict.md/json(最后逐 AC 生成)
434
+ 证据manifest: tmp/ty-context/plan-acceptance/<plan-slug>-evidence-manifest.md/json(可选slice小票,禁secret,非proof/第四输入/Context)
435
+ 可多开agent,agent名额不够了就关掉不用的。
436
+ 这是面向 Superpowers workflow Tiny Context 适配输入包,对齐官方 Superpowers skills;不是上游维护的 schema。
437
+ Tiny Context gates 只管 source authority/对图纸/验收,不重定义或分叉 Superpowers 执行机制。
438
+ Superpowers 输入包:
439
+ - Product/Architecture Source:原始产品/架构意图,防止 scope shrinkage,不是施工图
440
+ - Technical Realization Plan:施工图;每个行为 plan item 都要进 matrix
441
+ - Acceptance Checklist:最高验收标准;每个 AC 都要进 final verdict
442
+ - local audit:只记 progress/candidate status/evidence/blocker/invalidating evidence,不能裁判完成
443
+ - Context/tests/core paths:执行前读取,把 plan/AC gap 绑定到测试、API/UI/runtime/browser 证据
444
+ 权威:source scope,plan 管施工,checklist 管验收;audit/matrix/verdict/validator/auditor 不能改写它们。Proof index/evidence ledger/manifest 可选,但 complete 行必须能直接或经 evidence_id 追溯 fresh evidence。
445
+ Goal mode:实现/执行目标只在 product_goal_complete=true 时完成;只读审计目标可在 audit_task_complete 时结束,但若 verdict 非 accepted/complete,必须写“Audit workflow completed; acceptance target not complete.”并列数量;不得写 Goal achieved 或把 update_goal complete 当用户目标完成。
446
+
447
+ 执行顺序:
448
+ 1. 读三份输入和 Context。先写 Task Contract:Product Context Delta none|required;Technical Context Delta none|required;任一 required -> Context Delta required。这不是 validator gate。
449
+ 2. 用 Parent Context Delta 统一判断;每个 slice 继承它,只记录 new durable fact yes/no。Context Delta required 时先最小更新 owning project_context/** 或 DESIGN.md;不要把 audit/matrix/verdict/日志/截图/sample evidence 写进 Context。
450
+ 3. 检查技术实现方案覆盖产品/架构源关键要求;若只有产品方案没有技术实现方案,停止报告 missing Technical Realization Plan,不现场生成。
451
+ 4. 初始化 plan-conformance matrix;技术实现方案在本 Skill 输入校验阶段已确认可执行,直接绑定执行。
452
+ 5. 有 subagent 支持时优先 superpowers:subagent-driven-development,否则 superpowers:executing-plans。
453
+ 6. Plan/AC behavior gap -> superpowers:test-driven-development:先写 failing test 并 observe failure,再最小实现。
454
+ 7. 默认把同 AC/runtime/proof path 的 2-4 个 related missing layers 合成 slice;单 gap 只用于 blocker/contradiction/metadata cleanup。先分类 functional/proof/stale/upstream/live DB/Browser/security/all-runner gap;每 slice 更新可选 manifest,再同步 matrix/audit,verdict 只保守改 evidence/missing,不提前 complete。
455
+ 8. Candidate done 前跑 Plan Conformance Gate:测试通过不等于按图纸完成;sampled path 不等于 full implementation;每个行为 plan item 必须有 code/API/UI/runtime/test/evidence trace。
456
+ 9. 再跑 Acceptance Evidence Gate:按验收清单生成 final verdict;每 AC 写 required proof chain/fresh evidence/missing layers/drift/substitution。current contradiction 高于历史通过记录。
457
+ 10. Final gate 固定为 manifest -> matrix/verdict/audit sync -> verification-before-completion -> validator -> read-only auditor -> stale/overclaim scan;auditor summary 不是 proof。若审计后改 artifact/evidence,重跑 validator。
458
+
459
+ 权限/卡点:在当前平台/仓库/工具/用户已授权权限内最大自主推进;先打开相关 app/浏览器页面/CLI/系统设置,复用已有登录态/授权会话/凭据链;已授权 sudo/gsudo/admin elevation 先尝试。只有实际未登录/会话失效/权限不足/需要 MFA 或人工审批、缺账号/真实环境/敏感字段时才暂停,并给最小用户执行清单(页面/系统、字段位置、脱敏/勿发值、拿到后下一步)。
460
+ 禁止完成于:local audit、subagent summary、final card、只改代码/计划、只跑部分测试、旧/部分/抽样证据、缺 required layer、material drift、未批准 sibling substitution、runtime 未演练、artifact 未 accepted、API/UI 未 reflected、未批准 scope narrowing、任何 API/UI/data/runtime/test 矛盾。
461
+ ```
462
+
463
+ Recommended compact English prompt shape:
464
+
465
+ ```text
466
+ Base path: tmp/ty-context/plan-acceptance/<plan-slug>
467
+ Product / Architecture Source: <base>-product-architecture-source.md (scope)
468
+ Technical Realization Plan: <base>-technical-realization-plan.md (blueprint)
469
+ Acceptance Checklist: <base>-acceptance-checklist.md (authority)
470
+ Local audit: <base>-local-audit.md (log, not proof)
471
+ Plan matrix: <base>-plan-conformance-matrix.md/json (trace)
472
+ Final verdict: <base>-final-acceptance-verdict.md/json (AC)
473
+ Evidence manifest: <base>-evidence-manifest.md/json (optional note; no secrets; not proof/input/Context)
474
+ You may use multiple agents; if agent slots run low, close idle or unnecessary agents.
475
+ Tiny Context adapter for Superpowers; aligned to official skills, not upstream schema.
476
+ TC gates cover authority/conformance/acceptance, not Superpowers mechanics.
477
+ Superpowers input packet:
478
+ - Source guards scope; plan controls matrix; checklist controls verdict; audit records progress only.
479
+ - Read Context/tests/core paths first; map gaps to test/API/UI/runtime/browser evidence.
480
+ Authority: source/plan/checklist own scope/construction/acceptance; audit/matrix/verdict/validator/auditor cannot rewrite. Proof index/manifest optional; complete rows need fresh evidence/evidence_id.
481
+ Goal mode: implementation/execution complete only at product_goal_complete=true. Read-only audit may end at audit_task_complete; non-accepted verdict says "Audit workflow completed; acceptance target not complete."; no bare "Goal achieved" or update_goal complete as user target.
482
+
483
+ Execution order:
484
+ 1. Read inputs and Context. Task Contract: Product Context Delta none|required; Technical Context Delta none|required; any required -> Context Delta required. Not a validator gate.
485
+ 2. Use Parent Context Delta once; slices inherit it and record new durable fact yes/no. If required, update owning project_context/** or DESIGN.md; never store audit/matrix/verdict/logs/screenshots/sample evidence as Context.
486
+ 3. Check Technical Realization Plan covers Product / Architecture Source; if only product plan exists, stop with missing Technical Realization Plan.
487
+ 4. Init plan matrix; TRP was already validated as executable input, so bind it directly.
488
+ 5. Prefer superpowers:subagent-driven-development with subagents; otherwise use superpowers:executing-plans.
489
+ 6. Plan/AC behavior gap -> superpowers:test-driven-development: write a failing test, observe failure, then implement minimally.
490
+ 7. Batch slices: prefer 2-4 related missing layers sharing AC/runtime/proof path; single-gap only for blockers/contradictions/metadata cleanup. Classify gaps, write optional manifest, sync matrix/audit; update verdict conservatively, no AC complete before final gate.
491
+ 8. Plan Conformance Gate: tests do not prove conformance; sampled path is not full implementation; each behavior item needs code/API/UI/runtime/test/evidence trace.
492
+ 9. Acceptance Evidence Gate: checklist controls verdict; each AC records proof chain, fresh evidence, missing layers, drift, substitution. Current contradictions override old passes.
493
+ 10. Final gate: manifest -> matrix/verdict/audit sync -> verification-before-completion -> validator -> auditor -> stale/overclaim scan. Auditor summary is not proof; rerun validator after changes.
494
+
495
+ Autonomy/blockers: self-serve under current permissions. Open app/browser/CLI/settings and reuse sessions/auth/helpers. Try authorized sudo/gsudo/admin. Pause only after missing login/session expiry/denied permission/MFA/approval/missing env/account/field; give page/system, field, redaction, next step.
496
+ Never complete on: local audit, summary/final card, code/plan-only, partial tests/evidence, stale/sampled evidence, missing layer, material drift, unapproved substitution/scope narrowing, unexercised runtime, artifact not accepted, API/UI not reflected, missing validator pass or current API/UI/data/runtime/test contradiction.
497
+ ```
498
+
499
+ Before final response, check the prompt length. If it exceeds 3850 characters, tighten wording while preserving paths, input roles, official Superpowers skill names, Product Context Delta, Technical Context Delta, plan-conformance matrix, final verdict, state machine, UI gate, blockers and invalid evidence.
500
+
501
+ ## Final Response Requirements
502
+
503
+ When successful, return:
504
+
505
+ - The Product / Architecture Source path.
506
+ - The Technical Realization Plan path.
507
+ - The full checklist path.
508
+ - The local audit path.
509
+ - The plan-conformance matrix path.
510
+ - The final acceptance verdict path.
511
+ - Whether required input was complete.
512
+ - The generated prompt's Goal mode completion rule for implementation / execution goals, and required final status wording for non-accepted read-only audit results: `Audit workflow completed; acceptance target not complete.`
513
+ - The paste-ready Superpowers target-mode prompt in a code block.
514
+
515
+ When blocked, return:
516
+
517
+ - Missing Fields Report.
518
+ - `missing_section`.
519
+ - `missing_required_fields`.
520
+ - `why_blocking`.
521
+ - `cannot_infer_policy`.
522
+ - `required_next_input`.
523
+ - `suggested_upstream_action`.
524
+ - A clear statement that no Superpowers target-mode prompt was generated.
525
+
526
+ Do not claim any plan item or AC has passed unless the user explicitly asked for current completion audit and current evidence was inspected.
527
+
528
+ ## Forbidden Behaviors
529
+
530
+ Do not generate, derive, or infer the Technical Realization Plan.
531
+
532
+ Do not generate, derive, rewrite, strengthen, or repair the full checklist.
533
+
534
+ Do not execute the generated prompt.
535
+
536
+ Do not mark any goal complete.
537
+
538
+ Do not hide missing source files, ambiguous scope, weak evidence, implementation drift or blockers.
539
+
540
+ Do not include business-domain logic, concrete provider names, API names, UI names, artifact schemas or one-off project details in this package-managed Skill.