[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M77K36S4452RBQ397SFWGP35":3,"skill-same:01M77K36S4452RBQ397SFWGP35":45},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":24,"commitSha":25,"skillDirectory":26,"forksCount":27,"repositoryHtmlUrl":28,"repositoryHomepageUrl":6,"ownerHtmlUrl":29,"ownerBlogUrl":6,"ownerDescription":6,"updatedAt":30,"install":31,"resources":44},"01M77K36S4452RBQ397SFWGP35","tasks",null,"Generate a frozen task list from a frozen PRD using the spec union in one pass. Use when PRD is frozen and implementation tasks are needed before \u002Fsw-freeze. No mid-pass user gates; does not implement.","grdavies\u002Fshipwright","grdavies","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F2638082?v=4","01M77JZCZJTWB8WBWX4NNW8MNP","Ross Davies","01M77JZD0S2Q4JZEM0310T9A73",2,"MIT","https:\u002F\u002Fgithub.com\u002Fgrdavies\u002Fshipwright\u002Fblob\u002Fmain\u002Fcore\u002Fskills\u002Ftasks\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: tasks\ndescription: Generate a frozen task list from a frozen PRD using the spec union in one pass. Use when PRD is frozen and implementation tasks are needed before \u002Fsw-freeze. No mid-pass user gates; does not implement.\n---\n# Task list generation (`\u002Fsw-tasks`)\n\nPort of v1 `spec-tasks` under `sw-`. Reads U8 union so amended requirements are reflected.\n\n\n**Model tier:** deep — resolve via `python3 scripts\u002Fsw_bootstrap.py resolve-model-tier.py -- --skill tasks`. When using the Task tool for subagent dispatch, resolve concrete model IDs from `models.tiers` in config (never semantic tier names in subagent `model:` frontmatter).\n\n\n## Issue-store authoring (PRD 056 R11–R12)\n\nWhen effective backend is `issue-store`:\n\n1. **Never** write task lists under `docs\u002Fprds\u002F` in the code repo.\n2. Persist via `planning_store.put` with unit id `tasks-\u003Cn>-\u003Cslug>` and virtual body-path `docs\u002Fprds\u002F\u003Cn>-\u003Cslug>\u002Ftasks-\u003Cn>-\u003Cslug>.md`.\n3. Run gates on handles (materialize is deliver-time only):\n\n   ```bash\n   python3 scripts\u002Fspec-rigor-check.py --root \u003Cconsumer-repo> --artifact tasks --path \u003Cbody-path> --unit-id \u003Ctasks-unit-id>      --prd \u003Cprd-body-path> --prd-unit-id \u003Cprd-unit-id>\n   python3 scripts\u002Ftraceability-check.py --prd \u003Cprd-body-path> --tasks \u003Cbody-path> [--prd-unit-id …] [--tasks-unit-id …]\n   ```\n\n4. INDEX registration is mechanical reconcile \u002F living-docs — not a local `docs\u002Fprds\u002FINDEX.md` write.\n\nFile-store repos: unchanged — path and file save below apply.\n\n## DecisionGraph scope (PRD 280 R15)\n\nWhen task generation covers PRDs with an attached `DecisionGraph`:\n\n1. Include a `## DecisionGraph scope` subsection under each affected parent phase when decision nodes gate implementation.\n2. Reference the linked graph by **unit id** + virtual `docs\u002Fplanning\u002Fdecision\u002F\u003Cunit-id>\u002Fdecision-graph.json` — never assume a code-repo JSON file exists under issue-store.\n3. Phase dependency edges may reference decision-frontier readiness; cite `python3 scripts\u002Fplanning-graph.py decision-frontier --unit-id \u003Cprd-unit-id>` for read-only ready-set discovery.\n\n## Path\n\n`docs\u002Fprds\u002F\u003Cn>-\u003Cslug>\u002Ftasks-\u003Cn>-\u003Cslug>.md` per `.shipwright\u002Flayout.md`.\n\n## Procedure\n\n1. Require frozen PRD as input.\n2. Load effective spec via `scripts\u002Fspec-union.py` or `skills\u002Fspec-union\u002FSKILL.md`.\n3. In **one pass**, identify parent tasks (phases) and expand each into `- [ ]` sub-tasks with **executable shape** (IM6):\n   - Parent tasks: numbered, dependency-ordered, `small|medium|large` sizing from the deterministic heuristic (`### N.` headings; see **Phase sizing heuristic** below).\n   - Sub-tasks: **File**, **Expected**, **R-IDs** as below.\n   - Relevant Files + Notes as needed.\n   - **Prefer many small phases** with explicit `## Phase Dependencies` edges over few large sequential phases (R19).\n4. Emit **`## Phase Dependencies`** (required) — machine-parseable edge source for `\u002Fsw-deliver` phase-mode (R5\u002FR6\u002FR37). Place after `## Tasks` and before `## Traceability`.\n5. Run execute-tier granularity pass (see **Execute-tier granularity** below).\n6. Add `## Traceability` table mapping each union R-ID → task ref → named test scenario → **ZOMBIES checklist** (test-list-first; see `skills\u002Fspec-rigor\u002Freferences\u002Fzombies.md`).\n7. Save task file; run `spec-rigor-check.py --root \u003Cconsumer-repo>` (tasks) + `traceability-check.py`; freeze via `\u002Fsw-freeze`.\n   Installed spec-rigor requires consumer `--root`. Requirement bullets and task R-ID cites parse hyphen\n   **and asterisk** RID markers (`- **R1**` \u002F `* **R1**`); Linear `*` lists must extract on the stored body.\n8. Register\u002Frefresh PRD entry in `docs\u002Fprds\u002FINDEX.md` with status `not-started`.\n9. **Stop** — do not start implementation. Standalone `\u002Fsw-tasks` ends after freeze; `doc.afterTasks` on\n   `\u002Fsw-doc` owns the boundary to implementation.\n\n## Phase Dependencies table (required)\n\nEvery generated task list MUST include a `## Phase Dependencies` section with this table shape (parsed by\n`scripts\u002Fwave_deliver.py` in `\u002Fsw-deliver` phase-mode):\n\n```markdown\n## Phase Dependencies\n\n| Phase | Depends on |\n|-------|------------|\n| 1 | none |\n| 2 | 1 |\n| 3 | 1 |\n| 4 | 2, 3 |\n```\n\nRules:\n\n- **One row per phase** (`### N.` parent in `## Tasks`). Phase column is the integer `N` only.\n- **Depends on** is `none`, a single phase number, or comma-separated phase numbers (e.g. `2, 5`).\n- Edges are authoritative for `\u002Fsw-deliver` wave planning — derive from the dependency order of parent phases.\n- Human-reviewable; lives inside the task-list artifact (no sidecar file).\n\n### Deliver-time fallback (PRD 013 — legacy lists only)\n\n**Sequential fallback (R8):** when neither declared edges nor file-set inference apply, deliver assigns strict sequential edges with a notice.\n\n`\u002Fsw-tasks` **requires** `## Phase Dependencies` at freeze (`spec-rigor-check.py` blocks missing\u002Finvalid tables).\nFor **legacy** frozen lists that omit the table, `\u002Fsw-deliver` applies the PRD 013 ladder (authoritative in\n`skills\u002Fdeliver\u002FSKILL.md`):\n\n1. **Declared** — explicit `## Phase Dependencies` rows (always preferred at authoring time).\n2. **File-set inference** — overlapping `**File:**` paths infer serializing edges before wave assignment.\n3. **Sequential + notice** — strict `1→2→3…` edges with a missing-edges notice when inference finds no overlap.\n\nAuthors MUST emit explicit edges for new task lists — never rely on deliver-time fallback for multi-phase PRDs.\n\n## Phase sizing heuristic (PRD 040)\n\nReplace informal S\u002FM\u002FL labels with the deterministic scorer:\n\n```bash\npython3 scripts\u002Fphase_sizing.py score docs\u002Fprds\u002F\u003Cn>-\u003Cslug>\u002Ftasks-\u003Cn>-\u003Cslug>.md\npython3 scripts\u002Fphase_sizing.py advisory docs\u002Fprds\u002F\u003Cn>-\u003Cslug>\u002Ftasks-\u003Cn>-\u003Cslug>.md   # draft-only block\n```\n\nPer phase the scorer emits `size: small|medium|large` from structural signals (`filesTouched`,\n`traceabilityScenarios`, `depFanOut`, `subTaskCount`, `distinctDirs`) against `tasks.sizing.thresholds` in\nconfig. Thresholds and bounds (`minPhaseFiles`, `minPhaseScenarios`, `maxPhaseCount`) are documented in\n`core\u002Fsw-reference\u002Fphase-sizing.schema.json`.\n\n### Small-phase design constraint (R18)\n\n**Small phases are a design constraint** for reviewability and wave parallelism (Osmani on bounded change sets;\nFaros reports on agent PR size). Each phase SHOULD stay `small` or `medium` where practical. Splitting below the\n**minimum-viable-phase floor** (`belowFloor: true`) is not rewarded — avoid granularity DoS (many tiny phases\ninflating merge-gate load).\n\n### Prefer-many-small + split suggestions (R19)\n\n- Prefer **many small phases with declared dependency edges** over one large sequential phase.\n- When `overThreshold: true` or `separableSets` has multiple components, review the advisory split suggestion\n  (draft-only; stripped at freeze). Each proposed edge MUST respect contention families documented in\n  `skills\u002Fparallelism\u002FSKILL.md` (shared migrations, living INDEX\u002Fnumbering, `CHANGELOG`\u002F`version.txt`,\n  `**File:**` overlap, generator-output \u002F golden-manifest globs).\n- Adopting a split requires an unfrozen `\u002Fsw-tasks` re-run + `\u002Fsw-freeze` — never edit a frozen task list in place.\n\n## Executable sub-task shape\n\n```markdown\n- [ ] 1.1 Add tdd-gate script (R1)\n  - **File:** `scripts\u002Ftdd-gate.py`\n  - **Expected:** JSON verdict on stdout; exit 0 pass, 20 fail\n  - **R-IDs:** R1\n```\n\nParent phase items (`1.`, `2.`) may remain summary-level; **numbered sub-tasks** (`1.1`, `1.2`) carry File +\nExpected for `\u002Fsw-execute` plan-self-review.\n\n### Wiring proof (`Wired:` \u002F `Callsite:`) (PRD 085 R15)\n\nWhen a sub-task's **Expected** introduces a new production-reachable entry point in one of these **bounded\ncategories**, the row MUST declare a **`Wired:`** (or alias **`Callsite:`**) field naming the calling\nmodule or file that dispatches to \u002F registers the produced artifact:\n\n| Category | Example `Expected` signal |\n| --- | --- |\n| Script `main()` dispatch branch | \"new script's `main()` dispatch branch\" |\n| CLI subcommand | \"adds a new CLI subcommand\" |\n| Hook registration | \"new hook registration\" |\n| Backend \u002F adapter registration | \"backend\u002Fadapter registration function\" |\n| Workflow file | \"new workflow (`.github\u002Fworkflows\u002F*.yml`) file\" |\n\n```markdown\n- [ ] 3.2 Register the foo backend (R4)\n  - **File:** `scripts\u002Fcredentials\u002Fbackends\u002Ffoo.py`\n  - **Expected:** adds a new backend\u002Fadapter registration function\n  - **Wired:** `scripts\u002Fcredentials\u002Fresolver.py`\n  - **R-IDs:** R4\n```\n\n`tasks_generate.py check` enforces the field for rows matching these categories (not a general \"every\nartifact must declare a caller\" rule). `claims_audit.py brief` performs a bounded static reachability check\nthat the cited callsite file references the produced artifact in the branch diff (R16).\n\n## Execute-tier granularity (PRD 055 R16–R20)\n\nEvery generated task list MUST include bounded intra-phase sub-task refs sized for PRD 053 execute-tier\nfan-out. This is a **first-class generation requirement** alongside `## Phase Dependencies` and\n`## Traceability`.\n\n### Authoring procedure\n\nAfter drafting sub-tasks and before `\u002Fsw-freeze`:\n\n```bash\npython3 scripts\u002Ftasks_generate.py apply-granularity --task-list docs\u002Fprds\u002F\u003Cn>-\u003Cslug>\u002Ftasks-\u003Cn>-\u003Cslug>.md --inplace\npython3 scripts\u002Ftasks_generate.py check --task-list docs\u002Fprds\u002F\u003Cn>-\u003Cslug>\u002Ftasks-\u003Cn>-\u003Cslug>.md\n```\n\n`apply-granularity` decomposes list-shaped `**File:**` fields (comma\u002Fand-separated paths, glob lists)\ninto one ref per bounded file-set when contention rules permit parallelism. It emits a durable\n`## Execute-tier granularity` section with split preflight JSON — part of the frozen artifact, **not**\nthe advisory-only `## Sizing & Split Suggestions` block stripped at freeze.\n\nRe-numbering: when a ref splits (e.g. `3.1` → three units), refs within the phase are renumbered in order\n(`3.1`, `3.2`, `3.3`, …) preserving phase-local sequence.\n\n### Contention and serial edges\n\nWhen `phase_sizing.separable_sets_for_paths()` groups paths into one contention family, parallelism is\nforbidden — `apply-granularity` documents serial edges in the `## Execute-tier granularity` JSON rather\nthan emitting parallel refs.\n\n### Runtime escape hatch (R20)\n\n**Already frozen** coarse lists are never mutated. `execute_plan.py` runtime expansion remains the\nsanctioned fallback for in-flight deliver runs until the task list can be re-generated.\n\n\n## Blocking sizing freeze gate (PRD 065 R16)\n\nAt `\u002Fsw-freeze`, `spec-rigor-check.py` runs the **blocking** sizing gate (`phase_sizing.py\n`evaluate_freeze_gate`):\n\n- Over-threshold phases **block freeze** with split suggestions (same scorer as `phase_sizing.py score`).\n- Advisory `## Sizing & Split Suggestions` blocks are stripped before freeze — they do not satisfy the gate.\n- **Human override only** — durable record at `.cursor\u002Fsw-sizing-overrides\u002F\u003Ckey>.json` with `actor`,\n  `reason`, and `overThresholdPhases`. Agents on autonomous `\u002Fsw-doc` → `\u002Fsw-tasks` dispatch cannot author\n  overrides (`refuse_autonomous_override`).\n- Deliver-time sizing report (`\u002Fsw-deliver --sizing-report`) is read-only visibility — it does not bypass\n  the freeze gate.\n\n## Collision policy\n\n- **First run:** create the complete task file (parents, sub-tasks, phase dependencies, traceability) in one pass.\n- **Resume (unfrozen draft):** continue in the same file; do not duplicate sections.\n- **Re-run against frozen task list:** require explicit confirmation before full overwrite.\n- No sub-task-expansion gate — the human checkpoint between doc and implementation is `doc.afterTasks`\n  (orchestrator boundary), not `\u002Fsw-tasks`.\n\n## Handoff\n\n→ implementation workstream (`\u002Fsw-execute` when available) only after the doc orchestrator boundary (`doc.afterTasks`).\n","# Task list generation (`\u002Fsw-tasks`)\n\nPort of v1 `spec-tasks` under `sw-`. Reads U8 union so amended requirements are reflected.\n\n\n**Model tier:** deep — resolve via `python3 scripts\u002Fsw_bootstrap.py resolve-model-tier.py -- --skill tasks`. When using the Task tool for subagent dispatch, resolve concrete model IDs from `models.tiers` in config (never semantic tier names in subagent `model:` frontmatter).\n\n\n## Issue-store authoring (PRD 056 R11–R12)\n\nWhen effective backend is `issue-store`:\n\n1. **Never** write task lists under `docs\u002Fprds\u002F` in the code repo.\n2. Persist via `planning_store.put` with unit id `tasks-\u003Cn>-\u003Cslug>` and virtual body-path `docs\u002Fprds\u002F\u003Cn>-\u003Cslug>\u002Ftasks-\u003Cn>-\u003Cslug>.md`.\n3. Run gates on handles (materialize is deliver-time only):\n\n   ```bash\n   python3 scripts\u002Fspec-rigor-check.py --root \u003Cconsumer-repo> --artifact tasks --path \u003Cbody-path> --unit-id \u003Ctasks-unit-id>      --prd \u003Cprd-body-path> --prd-unit-id \u003Cprd-unit-id>\n   python3 scripts\u002Ftraceability-check.py --prd \u003Cprd-body-path> --tasks \u003Cbody-path> [--prd-unit-id …] [--tasks-unit-id …]\n   ```\n\n4. INDEX registration is mechanical reconcile \u002F living-docs — not a local `docs\u002Fprds\u002FINDEX.md` write.\n\nFile-store repos: unchanged — path and file save below apply.\n\n## DecisionGraph scope (PRD 280 R15)\n\nWhen task generation covers PRDs with an attached `DecisionGraph`:\n\n1. Include a `## DecisionGraph scope` subsection under each affected parent phase when decision nodes gate implementation.\n2. Reference the linked graph by **unit id** + virtual `docs\u002Fplanning\u002Fdecision\u002F\u003Cunit-id>\u002Fdecision-graph.json` — never assume a code-repo JSON file exists under issue-store.\n3. Phase dependency edges may reference decision-frontier readiness; cite `python3 scripts\u002Fplanning-graph.py decision-frontier --unit-id \u003Cprd-unit-id>` for read-only ready-set discovery.\n\n## Path\n\n`docs\u002Fprds\u002F\u003Cn>-\u003Cslug>\u002Ftasks-\u003Cn>-\u003Cslug>.md` per `.shipwright\u002Flayout.md`.\n\n## Procedure\n\n1. Require frozen PRD as input.\n2. Load effective spec via `scripts\u002Fspec-union.py` or `skills\u002Fspec-union\u002FSKILL.md`.\n3. In **one pass**, identify parent tasks (phases) and expand each into `- [ ]` sub-tasks with **executable shape** (IM6):\n   - Parent tasks: numbered, dependency-ordered, `small|medium|large` sizing from the deterministic heuristic (`### N.` headings; see **Phase sizing heuristic** below).\n   - Sub-tasks: **File**, **Expected**, **R-IDs** as below.\n   - Relevant Files + Notes as needed.\n   - **Prefer many small phases** with explicit `## Phase Dependencies` edges over few large sequential phases (R19).\n4. Emit **`## Phase Dependencies`** (required) — machine-parseable edge source for `\u002Fsw-deliver` phase-mode (R5\u002FR6\u002FR37). Place after `## Tasks` and before `## Traceability`.\n5. Run execute-tier granularity pass (see **Execute-tier granularity** below).\n6. Add `## Traceability` table mapping each union R-ID → task ref → named test scenario → **ZOMBIES checklist** (test-list-first; see `skills\u002Fspec-rigor\u002Freferences\u002Fzombies.md`).\n7. Save task file; run `spec-rigor-check.py --root \u003Cconsumer-repo>` (tasks) + `traceability-check.py`; freeze via `\u002Fsw-freeze`.\n   Installed spec-rigor requires consumer `--root`. Requirement bullets and task R-ID cites parse hyphen\n   **and asterisk** RID markers (`- **R1**` \u002F `* **R1**`); Linear `*` lists must extract on the stored body.\n8. Register\u002Frefresh PRD entry in `docs\u002Fprds\u002FINDEX.md` with status `not-started`.\n9. **Stop** — do not start implementation. Standalone `\u002Fsw-tasks` ends after freeze; `doc.afterTasks` on\n   `\u002Fsw-doc` owns the boundary to implementation.\n\n## Phase Dependencies table (required)\n\nEvery generated task list MUST include a `## Phase Dependencies` section with this table shape (parsed by\n`scripts\u002Fwave_deliver.py` in `\u002Fsw-deliver` phase-mode):\n\n```markdown\n## Phase Dependencies\n\n| Phase | Depends on |\n|-------|------------|\n| 1 | none |\n| 2 | 1 |\n| 3 | 1 |\n| 4 | 2, 3 |\n```\n\nRules:\n\n- **One row per phase** (`### N.` parent in `## Tasks`). Phase column is the integer `N` only.\n- **Depends on** is `none`, a single phase number, or comma-separated phase numbers (e.g. `2, 5`).\n- Edges are authoritative for `\u002Fsw-deliver` wave planning — derive from the dependency order of parent phases.\n- Human-reviewable; lives inside the task-list artifact (no sidecar file).\n\n### Deliver-time fallback (PRD 013 — legacy lists only)\n\n**Sequential fallback (R8):** when neither declared edges nor file-set inference apply, deliver assigns strict sequential edges with a notice.\n\n`\u002Fsw-tasks` **requires** `## Phase Dependencies` at freeze (`spec-rigor-check.py` blocks missing\u002Finvalid tables).\nFor **legacy** frozen lists that omit the table, `\u002Fsw-deliver` applies the PRD 013 ladder (authoritative in\n`skills\u002Fdeliver\u002FSKILL.md`):\n\n1. **Declared** — explicit `## Phase Dependencies` rows (always preferred at authoring time).\n2. **File-set inference** — overlapping `**File:**` paths infer serializing edges before wave assignment.\n3. **Sequential + notice** — strict `1→2→3…` edges with a missing-edges notice when inference finds no overlap.\n\nAuthors MUST emit explicit edges for new task lists — never rely on deliver-time fallback for multi-phase PRDs.\n\n## Phase sizing heuristic (PRD 040)\n\nReplace informal S\u002FM\u002FL labels with the deterministic scorer:\n\n```bash\npython3 scripts\u002Fphase_sizing.py score docs\u002Fprds\u002F\u003Cn>-\u003Cslug>\u002Ftasks-\u003Cn>-\u003Cslug>.md\npython3 scripts\u002Fphase_sizing.py advisory docs\u002Fprds\u002F\u003Cn>-\u003Cslug>\u002Ftasks-\u003Cn>-\u003Cslug>.md   # draft-only block\n```\n\nPer phase the scorer emits `size: small|medium|large` from structural signals (`filesTouched`,\n`traceabilityScenarios`, `depFanOut`, `subTaskCount`, `distinctDirs`) against `tasks.sizing.thresholds` in\nconfig. Thresholds and bounds (`minPhaseFiles`, `minPhaseScenarios`, `maxPhaseCount`) are documented in\n`core\u002Fsw-reference\u002Fphase-sizing.schema.json`.\n\n### Small-phase design constraint (R18)\n\n**Small phases are a design constraint** for reviewability and wave parallelism (Osmani on bounded change sets;\nFaros reports on agent PR size). Each phase SHOULD stay `small` or `medium` where practical. Splitting below the\n**minimum-viable-phase floor** (`belowFloor: true`) is not rewarded — avoid granularity DoS (many tiny phases\ninflating merge-gate load).\n\n### Prefer-many-small + split suggestions (R19)\n\n- Prefer **many small phases with declared dependency edges** over one large sequential phase.\n- When `overThreshold: true` or `separableSets` has multiple components, review the advisory split suggestion\n  (draft-only; stripped at freeze). Each proposed edge MUST respect contention families documented in\n  `skills\u002Fparallelism\u002FSKILL.md` (shared migrations, living INDEX\u002Fnumbering, `CHANGELOG`\u002F`version.txt`,\n  `**File:**` overlap, generator-output \u002F golden-manifest globs).\n- Adopting a split requires an unfrozen `\u002Fsw-tasks` re-run + `\u002Fsw-freeze` — never edit a frozen task list in place.\n\n## Executable sub-task shape\n\n```markdown\n- [ ] 1.1 Add tdd-gate script (R1)\n  - **File:** `scripts\u002Ftdd-gate.py`\n  - **Expected:** JSON verdict on stdout; exit 0 pass, 20 fail\n  - **R-IDs:** R1\n```\n\nParent phase items (`1.`, `2.`) may remain summary-level; **numbered sub-tasks** (`1.1`, `1.2`) carry File +\nExpected for `\u002Fsw-execute` plan-self-review.\n\n### Wiring proof (`Wired:` \u002F `Callsite:`) (PRD 085 R15)\n\nWhen a sub-task's **Expected** introduces a new production-reachable entry point in one of these **bounded\ncategories**, the row MUST declare a **`Wired:`** (or alias **`Callsite:`**) field naming the calling\nmodule or file that dispatches to \u002F registers the produced artifact:\n\n| Category | Example `Expected` signal |\n| --- | --- |\n| Script `main()` dispatch branch | \"new script's `main()` dispatch branch\" |\n| CLI subcommand | \"adds a new CLI subcommand\" |\n| Hook registration | \"new hook registration\" |\n| Backend \u002F adapter registration | \"backend\u002Fadapter registration function\" |\n| Workflow file | \"new workflow (`.github\u002Fworkflows\u002F*.yml`) file\" |\n\n```markdown\n- [ ] 3.2 Register the foo backend (R4)\n  - **File:** `scripts\u002Fcredentials\u002Fbackends\u002Ffoo.py`\n  - **Expected:** adds a new backend\u002Fadapter registration function\n  - **Wired:** `scripts\u002Fcredentials\u002Fresolver.py`\n  - **R-IDs:** R4\n```\n\n`tasks_generate.py check` enforces the field for rows matching these categories (not a general \"every\nartifact must declare a caller\" rule). `claims_audit.py brief` performs a bounded static reachability check\nthat the cited callsite file references the produced artifact in the branch diff (R16).\n\n## Execute-tier granularity (PRD 055 R16–R20)\n\nEvery generated task list MUST include bounded intra-phase sub-task refs sized for PRD 053 execute-tier\nfan-out. This is a **first-class generation requirement** alongside `## Phase Dependencies` and\n`## Traceability`.\n\n### Authoring procedure\n\nAfter drafting sub-tasks and before `\u002Fsw-freeze`:\n\n```bash\npython3 scripts\u002Ftasks_generate.py apply-granularity --task-list docs\u002Fprds\u002F\u003Cn>-\u003Cslug>\u002Ftasks-\u003Cn>-\u003Cslug>.md --inplace\npython3 scripts\u002Ftasks_generate.py check --task-list docs\u002Fprds\u002F\u003Cn>-\u003Cslug>\u002Ftasks-\u003Cn>-\u003Cslug>.md\n```\n\n`apply-granularity` decomposes list-shaped `**File:**` fields (comma\u002Fand-separated paths, glob lists)\ninto one ref per bounded file-set when contention rules permit parallelism. It emits a durable\n`## Execute-tier granularity` section with split preflight JSON — part of the frozen artifact, **not**\nthe advisory-only `## Sizing & Split Suggestions` block stripped at freeze.\n\nRe-numbering: when a ref splits (e.g. `3.1` → three units), refs within the phase are renumbered in order\n(`3.1`, `3.2`, `3.3`, …) preserving phase-local sequence.\n\n### Contention and serial edges\n\nWhen `phase_sizing.separable_sets_for_paths()` groups paths into one contention family, parallelism is\nforbidden — `apply-granularity` documents serial edges in the `## Execute-tier granularity` JSON rather\nthan emitting parallel refs.\n\n### Runtime escape hatch (R20)\n\n**Already frozen** coarse lists are never mutated. `execute_plan.py` runtime expansion remains the\nsanctioned fallback for in-flight deliver runs until the task list can be re-generated.\n\n\n## Blocking sizing freeze gate (PRD 065 R16)\n\nAt `\u002Fsw-freeze`, `spec-rigor-check.py` runs the **blocking** sizing gate (`phase_sizing.py\n`evaluate_freeze_gate`):\n\n- Over-threshold phases **block freeze** with split suggestions (same scorer as `phase_sizing.py score`).\n- Advisory `## Sizing & Split Suggestions` blocks are stripped before freeze — they do not satisfy the gate.\n- **Human override only** — durable record at `.cursor\u002Fsw-sizing-overrides\u002F\u003Ckey>.json` with `actor`,\n  `reason`, and `overThresholdPhases`. Agents on autonomous `\u002Fsw-doc` → `\u002Fsw-tasks` dispatch cannot author\n  overrides (`refuse_autonomous_override`).\n- Deliver-time sizing report (`\u002Fsw-deliver --sizing-report`) is read-only visibility — it does not bypass\n  the freeze gate.\n\n## Collision policy\n\n- **First run:** create the complete task file (parents, sub-tasks, phase dependencies, traceability) in one pass.\n- **Resume (unfrozen draft):** continue in the same file; do not duplicate sections.\n- **Re-run against frozen task list:** require explicit confirmation before full overwrite.\n- No sub-task-expansion gate — the human checkpoint between doc and implementation is `doc.afterTasks`\n  (orchestrator boundary), not `\u002Fsw-tasks`.\n\n## Handoff\n\n→ implementation workstream (`\u002Fsw-execute` when available) only after the doc orchestrator boundary (`doc.afterTasks`).\n",{"name":5,"description":7},"main","2633b37cdc50086084cc9c0ce6c994871d3e7aad","core\u002Fskills\u002Ftasks",0,"https:\u002F\u002Fgithub.com\u002Fgrdavies\u002Fshipwright","https:\u002F\u002Fgithub.com\u002Fgrdavies","2026-11-03 23:44:15",{"source":8,"skillName":5,"commands":32,"prompt":42,"zipAvailable":43},[33,36,39],{"tool":34,"command":35},"npx","npx skills add grdavies\u002Fshipwright --skill tasks",{"tool":37,"command":38},"bunx","bunx skills add grdavies\u002Fshipwright --skill tasks",{"tool":40,"command":41},"pnpm","pnpm dlx skills add grdavies\u002Fshipwright --skill tasks","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fgrdavies\u002Fshipwright\u002Fblob\u002Fmain\u002Fcore\u002Fskills\u002Ftasks\u002FSKILL.md",true,[],[46,53,60,67,73,80],{"skillNo":47,"name":48,"nameZh":6,"description":49,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":50,"categories":51,"keywords":52,"publishedAt":19},"01M77K4Z004VAMY705XQKJAH4Y","wrong-name","Missing use when phrase and wrong directory name for critical lint failure.","https:\u002F\u002Fgithub.com\u002Fgrdavies\u002Fshipwright\u002Fblob\u002Fmain\u002Fscripts\u002Ftest\u002Ffixtures\u002Fworkflow-pack-sdk\u002Fnegative\u002Fbad-instruction\u002Fskills\u002Fbad-skill\u002FSKILL.md",[],[],{"skillNo":54,"name":55,"nameZh":6,"description":56,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":57,"categories":58,"keywords":59,"publishedAt":19},"01M77K4WR3WP22SBT6053PYWAK","demo-skill","Demo workflow pack skill fixture. Use when validating workflow-pack-sdk golden paths in CI.","https:\u002F\u002Fgithub.com\u002Fgrdavies\u002Fshipwright\u002Fblob\u002Fmain\u002Fscripts\u002Ftest\u002Ffixtures\u002Fworkflow-pack-sdk\u002Fgolden\u002Fvalid-pack\u002Fskills\u002Fdemo-skill\u002FSKILL.md",[],[],{"skillNo":61,"name":62,"nameZh":6,"description":63,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":64,"categories":65,"keywords":66,"publishedAt":19},"01M77K4SV48XDDDQ81PD09G9N6","good-skill","Validates Agent Skills spec conformance for fixture trees. Use when testing skills-spec-guard pass paths across core and dist mirrors. Does not ship production skills.","https:\u002F\u002Fgithub.com\u002Fgrdavies\u002Fshipwright\u002Fblob\u002Fmain\u002Fscripts\u002Ftest\u002Ffixtures\u002Fskills-spec\u002Fpass-valid\u002Fcore\u002Fskills\u002Fgood-skill\u002FSKILL.md",[],[],{"skillNo":68,"name":48,"nameZh":6,"description":69,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":70,"categories":71,"keywords":72,"publishedAt":19},"01M77K4PWVT96VMTMMFE2Y80GJ","Fixture with name\u002Fdir mismatch for guard failure tests. Use when verifying skills-spec-guard rejects invalid identity. Does not ship production skills.","https:\u002F\u002Fgithub.com\u002Fgrdavies\u002Fshipwright\u002Fblob\u002Fmain\u002Fscripts\u002Ftest\u002Ffixtures\u002Fskills-spec\u002Ffail-name-mismatch\u002Fcore\u002Fskills\u002Fgood-skill\u002FSKILL.md",[],[],{"skillNo":74,"name":75,"nameZh":6,"description":76,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":77,"categories":78,"keywords":79,"publishedAt":19},"01M77K4KSS5Z0Q0DEAA8PV9316","bad-description","Missing the required when trigger phrase in this fixture skill.","https:\u002F\u002Fgithub.com\u002Fgrdavies\u002Fshipwright\u002Fblob\u002Fmain\u002Fscripts\u002Ftest\u002Ffixtures\u002Fskills-spec\u002Ffail-description-shape\u002Fcore\u002Fskills\u002Fbad-description\u002FSKILL.md",[],[],{"skillNo":81,"name":82,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":83,"categories":84,"keywords":85,"publishedAt":19},"01M77K4H9HK5FDF84D65228XFA","dropin-demo","https:\u002F\u002Fgithub.com\u002Fgrdavies\u002Fshipwright\u002Fblob\u002Fmain\u002Fscripts\u002Ftest\u002Ffixtures\u002Fcapability-select\u002Fdropin\u002Fcore\u002Fskills\u002Fdropin-demo\u002FSKILL.md",[],[]]