[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M75H3P52JFP75WA2RHPBN2YF":3,"skill-same:01M75H3P52JFP75WA2RHPBN2YF":82},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":15,"categories":16,"keywords":17,"publishedAt":18,"linkOnly":19,"markdownContent":20,"markdownBody":21,"frontMatter":22,"refName":23,"commitSha":24,"skillDirectory":25,"forksCount":13,"repositoryHtmlUrl":26,"repositoryHomepageUrl":27,"ownerHtmlUrl":28,"ownerBlogUrl":6,"ownerDescription":6,"updatedAt":29,"install":30,"resources":43},"01M75H3P52JFP75WA2RHPBN2YF","forge-3-specs",null,"Generate numbered implementation spec documents from PRD and tech spec in the forge pipeline. Use when user runs \u002Fskill:forge-3-specs or asks to create detailed implementation specs for a forge feature after tech spec completion. Do NOT trigger for general specification writing, design docs, or implementation planning outside the forge pipeline.","garygentry\u002Ffeature-forge","garygentry","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F12444042?v=4","01M75GWTRXHQMKFWDVG9N8ENNS","01M75GWTSZ5NV3MYKFWVCZJKW4",0,"MIT","https:\u002F\u002Fgithub.com\u002Fgarygentry\u002Ffeature-forge\u002Fblob\u002Fmain\u002Fadapters\u002Fpi\u002Fskills\u002Fforge-3-specs\u002FSKILL.md",[],[],"2026-11-12 13:55:43",false,"---\n# GENERATED — DO NOT EDIT. Source: skills\u002Fforge-3-specs\u002FSKILL.md. Regenerate: python3 scripts\u002Fbuild-adapters.py\nname: forge-3-specs\ndescription: Generate numbered implementation spec documents from PRD and tech spec in the forge pipeline. Use when user runs \u002Fskill:forge-3-specs or asks to create detailed implementation specs for a forge feature after tech spec completion. Do NOT trigger for general specification writing, design docs, or implementation planning outside the forge pipeline.\n---\n\n# forge-3-specs — Implementation Spec Suite Generator\n\nGenerate a comprehensive suite of numbered implementation specification documents that provide everything needed to implement a feature.\n\n## Prerequisites\n\nRead and follow `references\u002Fshared-conventions.md` for feature name validation, configuration reading, and force mode handling before proceeding.\n\n**Turn structure reminder:** Text first, then `AskUserQuestion` for all questions — never embed one in your text (it stalls). At rung 2\u002F3, see the Interaction Capability Ladder.\n\n## Step 1: Validate Prerequisites\n\n**Resolve the feature directory first** via the **Feature Directory Resolution** block in `references\u002Fshared-conventions.md`, setting `{resolvedFeatureDir}`.\n\n**Prerequisite check:** Read `{resolvedFeatureDir}\u002F.pipeline-state.json`. If not in force mode, both `forge-1-prd` and `forge-2-tech` must be `complete`. If not, STOP and tell the user which prerequisites are missing.\n\n**Carried-over note check.** If that state's top-level `notes` is a non-empty string, surface it verbatim before proceeding and treat it as input to this stage — it was persisted for exactly this cross-session handoff (often at the previous stage's exit). It never overrides the PRD, tech spec, or config; raise any conflict instead of silently following either side.\n\nAfter the prerequisite check, invoke the **Stage-Entry Guard** block in `references\u002Fshared-conventions.md` with `{stage}` = `forge-3-specs`. Because this stage writes a suite incrementally, the guard's **interrupted** arm uses the `stages.forge-3-specs.artifacts` array (already updated after each spec file — Step 3) to resume from the first unwritten document rather than regenerating the whole suite.\n\nRead both `{resolvedFeatureDir}\u002FPRD.md` and `{resolvedFeatureDir}\u002Ftech-spec.md` into context.\n\nAfter reading the PRD and tech spec, invoke the **Epic Context Injection** block in `references\u002Fshared-conventions.md`. It self-gates on the resolved feature's `epic` back-pointer: for a standalone feature it is a no-op; for an epic member it loads EPIC.md, this feature's charter, and the completed direct dependencies' specs into context before the spec suite is planned.\n\n## Step 2: Examine Existing Context\n\n1. **Read the PRD and tech spec thoroughly**: These are your source of truth\n2. **Examine the existing codebase**: Look at how other packages are structured, what patterns they follow, what types they export\n3. **Check other features' implementation specs**: Look at `{specsDir}\u002F*\u002F[0-9][0-9]-*.md` AND `{specsDir}\u002F*\u002F*\u002F[0-9][0-9]-*.md` (depth-2, for epic-nested features) for consistency in format and depth. Subject to the **feature-shaped-dir bound**: only treat a matched directory as a feature if it directly contains a `.pipeline-state.json` (per the Feature Directory Resolution block) — ignore `EPIC.md` directories and other non-feature subtrees. Flat-only trees gain no new matches from the depth-2 glob, so standalone behavior is unchanged (REQ-COMPAT-01).\n4. **Read integration target code**: For every package listed as an integration point in the tech spec, read its actual source — types, exports, patterns. For every integration point, include the EXACT function signature and import path you read from the source code. Include the file path where you found it. If you cannot locate an expected export, say so explicitly: 'WARNING: Could not locate X export in {module} — verify this exists before implementing.'\n5. **Read spec examples**: Read `references\u002Fspec-examples.md` for the expected depth and quality of spec sections. These examples are your quality bar.\n\n## Step 3: Plan the Document Suite\n\nRead `references\u002Fspec-archetypes.md` for the menu of document types.\n\nBased on the feature's complexity, propose a document plan to the user before writing. Output the document list as text, then use `AskUserQuestion` for the question — do NOT include the question in your text output.\n\n**Example text output (no question here):**\n```\nI'll create the following spec documents for {feature}:\n\nRequired:\n  00-core-definitions.md     — Type definitions, error hierarchy, shared contracts\n  01-architecture-layout.md   — Directory structure, exports map, dependency graph\n  NN-testing-strategy.md      — Test approach, coverage targets, fixture patterns\n\nFeature-specific:\n  02-{subsystem-a}.md         — {Brief description}\n  03-{subsystem-b}.md         — {Brief description}\n  04-integration-points.md    — Integration with existing project modules\n```\n\n**Then call `AskUserQuestion`** following the **Decision Support** protocol in `references\u002Fshared-conventions.md`: recommend this plan as the default (it's your evidence-backed read of the feature's complexity) and name the trade-off so the user can push back knowingly — more documents means finer separation of concerns but more to keep in sync; fewer means tighter docs but risks one document carrying multiple concerns. Lead with: \"I recommend this plan. Add or remove any documents?\" Note the guidance below — resist splitting a concern into a sub-50-line document.\n\n**Incremental artifact tracking:** After each spec document is written (by you or a writer subagent), immediately run `state-artifact` with the new file path — once per file, not once at the end. This enables crash recovery if the session is interrupted mid-suite (see shared-conventions.md \"Stage-Entry Guard\"). Add `--epic \"{epic}\"` when this feature is an epic member — required, per the Pipeline State Protocol.\n\n```bash\nR=\"$(bash -c '[ -z \"${FEATURE_FORGE_ROOT:-}\" ] || [ -x \"$FEATURE_FORGE_ROOT\u002Fscripts\u002Fforge-root.sh\" ] || { echo \"feature-forge: FEATURE_FORGE_ROOT=$FEATURE_FORGE_ROOT has no scripts\u002Fforge-root.sh\" >&2; exit 2; }; for d in \"${FEATURE_FORGE_ROOT:-}\" \"${CLAUDE_PLUGIN_ROOT:-}\" \"$HOME\"\u002F.claude\u002Fskills\u002Ffeature-forge \"$HOME\"\u002F.claude\u002Fplugins\u002Fcache\u002F*\u002Ffeature-forge\u002F* \"$HOME\"\u002F.claude\u002Fplugins\u002F*\u002Ffeature-forge \"$HOME\"\u002F.agents\u002Fskills\u002Ffeature-forge .\u002F.agents\u002Fskills\u002Ffeature-forge; do [ -x \"$d\u002Fscripts\u002Fforge-root.sh\" ] && exec \"$d\u002Fscripts\u002Fforge-root.sh\"; done')\"\n[ -n \"$R\" ] || { echo \"feature-forge: cannot locate plugin root\" >&2; exit 1; }\npython3 \"$R\u002Fscripts\u002Fforge-session.py\" state-artifact \\\n  --feature \"{feature}\" --stage forge-3-specs --path \"\u003Cfile>\" --specs-dir \"{specsDir}\"\n```\n\n## Step 4: Write the Spec Suite\n\nThe suite has a hard internal dependency: every domain\u002Fintegration doc references the\nshared types and layout from `00-core-definitions.md` and `01-architecture-layout.md`.\nSo author in two phases — a sequential foundation, then a parallel fan-out.\n\n### 4a. Foundation pass (sequential, you author)\n\nWrite `00-core-definitions.md` and `01-architecture-layout.md` yourself, in the main\nsession, **before** anything else. Every later document depends on these shared types\nand the directory\u002Fexports map, so they must exist and be stable first.\n\n### 4b. Domain fan-out (parallel `forge-spec-writer` subagents)\n\nOnce the foundation is written, dispatch the remaining numbered docs in parallel — **one\n`forge-spec-writer` subagent per document, in a single message with multiple subagent\ncalls** (the `superpowers:dispatching-parallel-agents` pattern). Each writer is given:\n- the PRD and tech-spec,\n- the just-written `00-core-definitions.md` and `01-architecture-layout.md` (so it builds\n  on the shared types, not its own),\n- the stack profile path `references\u002Fstacks\u002F{stack}.md` (if `stack` is set in config),\n- the quality bar in `references\u002Fspec-examples.md`,\n- the **exact single filename it must write** and the archetype slice (from\n  `references\u002Fspec-archetypes.md`) it covers.\n- **(epic members only — additive context):** the relevant `EPIC.md` Contracts section(s)\n  for this feature, and the `tech-spec.md` of each completed direct dependency at {paths} — so\n  the doc is written against real upstream contracts, not guesses.\n\nEach writer authors **only its one assigned file** and returns a short **manifest** of\nthe `REQ-XXX-NN` IDs it covered (feeds Step 5 traceability). Author `NN-testing-strategy.md`\nlast (it can be its own writer, or you author it once the others' shapes are known).\n\n**Fallback (no subagents available):** author the documents yourself in batches of 3–5,\nfoundation first; after each batch, optionally commit\n(`git add {specsDir}\u002F{feature}\u002F && git commit -m \"{commitPrefix}({feature}): specs batch {n}\"`)\nand re-read only `00-core-definitions.md` plus the upstream docs the next batch needs —\ndo not reload everything. This keeps quality up under context pressure.\n\n### Quality requirements (every document, whoever writes it)\n\n1. Number sequentially: `00-`, `01-`, `02-`, etc.\n2. Every implementation detail MUST trace to either a PRD requirement (REQ-XXX-NN) or a tech-spec decision\n3. Before the body, include a `## Requirement Coverage` table mapping every REQ-XXX-NN this document covers to the section that implements it\n4. Include complete type definitions, data structures, and function signatures in the project's language — not pseudocode. If a stack profile exists at `references\u002Fstacks\u002F{stack}.md` (where `{stack}` comes from `forge.config.json`), follow its conventions for type definitions, error hierarchies, and documentation comments.\n5. Include error handling for every operation\n6. Include example usage where it aids clarity\n7. Cross-reference other spec documents by filename when one document depends on definitions from another\n\n### Document Conventions\n\n- Filename format: `{specsDir}\u002F{feature}\u002F##-\u003Cdescriptive-name>.md`\n- Each document should be self-contained enough that an engineer could implement it without reading other spec docs (though cross-references help for context)\n- Include a \"Dependencies\" section listing which other spec docs must be implemented first\n- Include a \"Verification\" section describing how to confirm the implementation matches the spec\n\n## Step 5: Cross-Reference Validation\n\nBefore writing `TRACEABILITY.md` or running the stage exit, invoke the **Stage-Completion Re-check** block in `references\u002Fshared-conventions.md` with `{stage}` = `forge-3-specs` — a resumed mid-stage continuation must not overwrite a committed `TRACEABILITY.md` or re-fire a finished exit.\n\nAfter writing all documents, verify:\n\n1. Every PRD requirement has coverage in at least one spec document\n2. Every tech-spec decision is reflected in the implementation specs\n3. Cross-references between spec documents are consistent (no broken references)\n4. Type definitions used across documents are consistent\n5. No orphaned implementation details that don't trace to requirements\n6. Produce a traceability matrix: a markdown table mapping every REQ-XXX-NN from the PRD to the spec document and section that implements it. Write this to `{resolvedFeatureDir}\u002FTRACEABILITY.md`\n\nList any gaps or inconsistencies found and resolve them.\n\n## Step 6: Review with User\n\nThis is a **blocking review** — per the **Stage Review Gate** in `references\u002Fshared-conventions.md`, do not proceed until the user confirms.\n\nPresent a summary of all documents created as text, with key decisions highlighted. Then use `AskUserQuestion` to collect feedback — do NOT include these questions in your text output:\n\n\"1. Does the level of detail match what you need? 2. Any areas that need more depth? 3. Any missing subsystems or concerns?\"\n\n## Step 7: Update Pipeline State and Commit\n\nPipeline state is written by the `state-*` verbs — see the Pipeline State Protocol in `references\u002Fshared-conventions.md`.\n\n1. Record completion by running `state-complete` (below) with `--version`, one `--artifact` per created file including `TRACEABILITY.md`, and `--based-on forge-1-prd=\u003Ccurrent version> --based-on forge-2-tech=\u003Ccurrent version>`. It sets `status: \"complete\"`, `completedAt`, the version and `basedOnVersions`, and applies the downstream staleness cascade deterministically, so no downstream status is set by hand.\n2. **Offer a note — don't force one.** As a statement (not a blocking question), let the user know they can jot anything worth preserving across sessions and you'll store it in the `notes` field. If they volunteer something, store it via `state-note` — it **overwrites** the single `notes` string (latest note wins), so fold any still-relevant existing note into the one combined string; otherwise proceed. The next stage's Step 1 reads and surfaces this note.\n3. If `gitCommitAfterStage` is true, follow the Git Commit Protocol in `references\u002Fshared-conventions.md`: stage files, attempt commit with message `\"{commitPrefix}({feature}): complete implementation specs v{n}\"` (marking `stages.forge-3-specs.status` `complete` with `commitHash: null` in that commit), then record the artifact-commit hash via the protocol's two-commit follow-up (never `--amend`) only on success. If commit fails, leave status as `in-progress`.\n4. **Close with the Stage Exit Protocol** (single-sourced in `references\u002Fstage-exit-protocol.md`; do not improvise a \"Next steps\" list). Specs feed every downstream stage, so the verify gate matters here:\n\nThe `state-complete` call for item 1 — and the `state-note` call only when the user volunteered a note in item 2 — with the portable plugin-root prelude. Add `--epic \"{epic}\"` to each call when this feature is an epic member — required, per the Pipeline State Protocol in `references\u002Fshared-conventions.md`:\n\n```bash\nR=\"$(bash -c '[ -z \"${FEATURE_FORGE_ROOT:-}\" ] || [ -x \"$FEATURE_FORGE_ROOT\u002Fscripts\u002Fforge-root.sh\" ] || { echo \"feature-forge: FEATURE_FORGE_ROOT=$FEATURE_FORGE_ROOT has no scripts\u002Fforge-root.sh\" >&2; exit 2; }; for d in \"${FEATURE_FORGE_ROOT:-}\" \"${CLAUDE_PLUGIN_ROOT:-}\" \"$HOME\"\u002F.claude\u002Fskills\u002Ffeature-forge \"$HOME\"\u002F.claude\u002Fplugins\u002Fcache\u002F*\u002Ffeature-forge\u002F* \"$HOME\"\u002F.claude\u002Fplugins\u002F*\u002Ffeature-forge \"$HOME\"\u002F.agents\u002Fskills\u002Ffeature-forge .\u002F.agents\u002Fskills\u002Ffeature-forge; do [ -x \"$d\u002Fscripts\u002Fforge-root.sh\" ] && exec \"$d\u002Fscripts\u002Fforge-root.sh\"; done')\"\n[ -n \"$R\" ] || { echo \"feature-forge: cannot locate plugin root\" >&2; exit 1; }\npython3 \"$R\u002Fscripts\u002Fforge-session.py\" state-complete \\\n  --feature \"{feature}\" --stage forge-3-specs --version {n} \\\n  --based-on \"forge-1-prd=\u003Cn>\" --based-on \"forge-2-tech=\u003Cn>\" \\\n  --artifact \"\u003Cfile>\" --artifact TRACEABILITY.md --specs-dir \"{specsDir}\"\n# ONLY run the next call if the user volunteered a note in item 2 — otherwise stop here.\npython3 \"$R\u002Fscripts\u002Fforge-session.py\" state-note \\\n  --feature \"{feature}\" --note \"\u003Cwhat the user volunteered>\" --specs-dir \"{specsDir}\"\n```\n\n**Determine `--verify-capability` before running the exit** per **Host and capability determination** in `references\u002Fstage-exit-protocol.md` (summarized under **Verify Capability** in `references\u002Fshared-conventions.md`): pass `interactive` only when a question mechanism equivalent to `AskUserQuestion` is available **and** dispatching a clean-room `forge-verifier` is *permitted* (the test is \"may I dispatch right now\", not tool presence) — otherwise `manual`. That reference owns the full rule, including why a consent-only bar is still `interactive` and the `none`-gate consent variant. Add `--epic \"{epic}\"` to the call below when this feature is an epic member.\n\n**Close this stage with the Scripted Stage Exit** (contract: `references\u002Fstage-exit-protocol.md`; do not improvise a \"Next steps\" list). Run:\n\n```bash\nR=\"$(bash -c '[ -z \"${FEATURE_FORGE_ROOT:-}\" ] || [ -x \"$FEATURE_FORGE_ROOT\u002Fscripts\u002Fforge-root.sh\" ] || { echo \"feature-forge: FEATURE_FORGE_ROOT=$FEATURE_FORGE_ROOT has no scripts\u002Fforge-root.sh\" >&2; exit 2; }; for d in \"${FEATURE_FORGE_ROOT:-}\" \"${CLAUDE_PLUGIN_ROOT:-}\" \"$HOME\"\u002F.claude\u002Fskills\u002Ffeature-forge \"$HOME\"\u002F.claude\u002Fplugins\u002Fcache\u002F*\u002Ffeature-forge\u002F* \"$HOME\"\u002F.claude\u002Fplugins\u002F*\u002Ffeature-forge \"$HOME\"\u002F.agents\u002Fskills\u002Ffeature-forge .\u002F.agents\u002Fskills\u002Ffeature-forge; do [ -x \"$d\u002Fscripts\u002Fforge-root.sh\" ] && exec \"$d\u002Fscripts\u002Fforge-root.sh\"; done')\"\n[ -n \"$R\" ] || { echo \"feature-forge: cannot locate plugin root\" >&2; exit 1; }\npython3 \"$R\u002Fscripts\u002Fforge-session.py\" stage-exit --feature \"{feature}\" --stage forge-3-specs --specs-dir \"{specsDir}\" --host pi --verify-capability \"{verify-capability}\"\n```\n\nObey the DIRECTIVES it prints, in the consumption order this protocol fixes: surface `invalidAutoVerifyKeys` and every `warnings` entry first; `runInStageVerify: true` → run the in-stage clean-room verify chain now (honoring `autoFixEligible`, and asking through the Standard Verify Gate first when you may not dispatch unsolicited); `verifyGate: \"standard\"` → present the Standard Verify Gate; `verifyGate: \"manual-print\"` → print the `verifyCommand` for the user and do **not** dispatch inline. Then, and only when `terminalOwnedBy` is `\"self\"`, **print the NEXT-STEPS block verbatim as your absolute last output — nothing after its sentinel line.** A `terminalOwnedBy: \"outer\"` payload carries `nextSteps: null`: return your structured result to the caller and print no terminal block at all.\n\n## Gotchas\n\n- Don't create specs for things that are already fully specified in the tech spec. If the tech spec has complete type definitions, the implementation spec should reference them, not duplicate them.\n- Every spec document should include complete type definitions and function signatures in the project's language with documentation comments. The backlog generator and implementing engineer depend on these being exact, not approximate.\n- Resist the urge to create too many documents. Each document should represent a major concern. If a \"document\" would be under 50 lines, it probably belongs as a section in another document.\n- Watch for implicit dependencies between subsystems. If subsystem A's types are used by subsystem B, the spec should explicitly state this and ensure the types are defined in the shared types document.\n- If the feature is large, the spec suite might be 8-12 documents. If it's simple, 3-4 is fine. Match complexity to the feature, not a fixed template.\n\n---\n\n## Host execution notes (Pi)\n\nThis Pi bundle preserves Claude's `AskUserQuestion` references because it ships a Pi compatibility extension registering an `AskUserQuestion` tool. On Pi:\n\n- **User input:** use `AskUserQuestion` for genuine user decisions. It supports multiple questions, option descriptions, recommended ordering, multi-select, previews, and free-form Other\u002Fcustom answers.\n- **Non-interactive (`-p`\u002F`--mode json`):** `AskUserQuestion` is stripped from the tool list, so its absence alone cannot tell you the rung — read that from the Interaction Capability Ladder's `interaction-mode` record. A call attempted anyway fails with `Error: UI not available (running in non-interactive mode)` — never read that as a decline. Take the Interaction Capability Ladder's declared conservative default, state it in your output, and use `no-default: abort — \u003Cquestion> requires a human answer` for an interview question with no sane default (`references\u002Fshared-conventions.md`).\n- **Skill dispatch:** Pi uses `\u002Fskill:\u003Cname>` commands. If you cannot invoke a skill directly, print the exact `\u002Fskill:\u003Cname> ...` command for the user to run. A **forge-invocation-args** compatibility extension wraps the arguments of a `\u002Fskill:forge-*` command in a `\u003Cfeature-forge-invocation>` envelope before Pi expands it, so read the feature name from that envelope's `\u003Carguments>` element (an empty element means none was supplied) rather than from unlabeled trailing text — see `references\u002Fshared-conventions.md` § Feature Name Requirement.\n- **Subagents:** this bundle declares its custom agents (`forge-researcher`, `forge-spec-writer`, `forge-verifier`) as package agents. If a `subagent` tool is registered, dispatch one with `{ agent: \"forge-verifier\", task: \"...\" }`, or fan several out concurrently with `{ tasks: [{ agent: \"forge-spec-writer\", task: \"...\" }, ...] }`. If no `subagent` tool is available, run that step inline yourself.\n- **Background \u002F monitoring (forge-5-loop):** run the loop through **rauf's Pi package** (`pi install npm:@garygentry\u002Frauf`, rauf >= 0.18.0), whose `rauf-loop-supervisor` extension registers `rauf_loop_launch`, `rauf_loop_status`, `rauf_loop_wait` and `rauf_loop_stop`. Launch with `rauf_loop_launch`; it starts the loop **detached** (it outlives this session), posts a one-line card per completed item, and **wakes this session** on needs-human, blocked, stuck, review failure, loop errors and completion — so end your turn after the launch: do not poll, sleep, tail, run the loop in the foreground or behind `nohup`\u002F`&`, or hand it to a subagent (the extension blocks those calls). Read `rauf_loop_status` before acting on a wake; use `rauf_loop_stop` only to deliberately stop the runner. Full detail: `references\u002Frunner-contract.md` Steps 3b\u002F3d. If the `rauf_loop_*` tools are not registered, `forge-session.py doctor` says how to install the package; until then use the `rauf loop wait` recipe there.\n","# forge-3-specs — Implementation Spec Suite Generator\n\nGenerate a comprehensive suite of numbered implementation specification documents that provide everything needed to implement a feature.\n\n## Prerequisites\n\nRead and follow `references\u002Fshared-conventions.md` for feature name validation, configuration reading, and force mode handling before proceeding.\n\n**Turn structure reminder:** Text first, then `AskUserQuestion` for all questions — never embed one in your text (it stalls). At rung 2\u002F3, see the Interaction Capability Ladder.\n\n## Step 1: Validate Prerequisites\n\n**Resolve the feature directory first** via the **Feature Directory Resolution** block in `references\u002Fshared-conventions.md`, setting `{resolvedFeatureDir}`.\n\n**Prerequisite check:** Read `{resolvedFeatureDir}\u002F.pipeline-state.json`. If not in force mode, both `forge-1-prd` and `forge-2-tech` must be `complete`. If not, STOP and tell the user which prerequisites are missing.\n\n**Carried-over note check.** If that state's top-level `notes` is a non-empty string, surface it verbatim before proceeding and treat it as input to this stage — it was persisted for exactly this cross-session handoff (often at the previous stage's exit). It never overrides the PRD, tech spec, or config; raise any conflict instead of silently following either side.\n\nAfter the prerequisite check, invoke the **Stage-Entry Guard** block in `references\u002Fshared-conventions.md` with `{stage}` = `forge-3-specs`. Because this stage writes a suite incrementally, the guard's **interrupted** arm uses the `stages.forge-3-specs.artifacts` array (already updated after each spec file — Step 3) to resume from the first unwritten document rather than regenerating the whole suite.\n\nRead both `{resolvedFeatureDir}\u002FPRD.md` and `{resolvedFeatureDir}\u002Ftech-spec.md` into context.\n\nAfter reading the PRD and tech spec, invoke the **Epic Context Injection** block in `references\u002Fshared-conventions.md`. It self-gates on the resolved feature's `epic` back-pointer: for a standalone feature it is a no-op; for an epic member it loads EPIC.md, this feature's charter, and the completed direct dependencies' specs into context before the spec suite is planned.\n\n## Step 2: Examine Existing Context\n\n1. **Read the PRD and tech spec thoroughly**: These are your source of truth\n2. **Examine the existing codebase**: Look at how other packages are structured, what patterns they follow, what types they export\n3. **Check other features' implementation specs**: Look at `{specsDir}\u002F*\u002F[0-9][0-9]-*.md` AND `{specsDir}\u002F*\u002F*\u002F[0-9][0-9]-*.md` (depth-2, for epic-nested features) for consistency in format and depth. Subject to the **feature-shaped-dir bound**: only treat a matched directory as a feature if it directly contains a `.pipeline-state.json` (per the Feature Directory Resolution block) — ignore `EPIC.md` directories and other non-feature subtrees. Flat-only trees gain no new matches from the depth-2 glob, so standalone behavior is unchanged (REQ-COMPAT-01).\n4. **Read integration target code**: For every package listed as an integration point in the tech spec, read its actual source — types, exports, patterns. For every integration point, include the EXACT function signature and import path you read from the source code. Include the file path where you found it. If you cannot locate an expected export, say so explicitly: 'WARNING: Could not locate X export in {module} — verify this exists before implementing.'\n5. **Read spec examples**: Read `references\u002Fspec-examples.md` for the expected depth and quality of spec sections. These examples are your quality bar.\n\n## Step 3: Plan the Document Suite\n\nRead `references\u002Fspec-archetypes.md` for the menu of document types.\n\nBased on the feature's complexity, propose a document plan to the user before writing. Output the document list as text, then use `AskUserQuestion` for the question — do NOT include the question in your text output.\n\n**Example text output (no question here):**\n```\nI'll create the following spec documents for {feature}:\n\nRequired:\n  00-core-definitions.md     — Type definitions, error hierarchy, shared contracts\n  01-architecture-layout.md   — Directory structure, exports map, dependency graph\n  NN-testing-strategy.md      — Test approach, coverage targets, fixture patterns\n\nFeature-specific:\n  02-{subsystem-a}.md         — {Brief description}\n  03-{subsystem-b}.md         — {Brief description}\n  04-integration-points.md    — Integration with existing project modules\n```\n\n**Then call `AskUserQuestion`** following the **Decision Support** protocol in `references\u002Fshared-conventions.md`: recommend this plan as the default (it's your evidence-backed read of the feature's complexity) and name the trade-off so the user can push back knowingly — more documents means finer separation of concerns but more to keep in sync; fewer means tighter docs but risks one document carrying multiple concerns. Lead with: \"I recommend this plan. Add or remove any documents?\" Note the guidance below — resist splitting a concern into a sub-50-line document.\n\n**Incremental artifact tracking:** After each spec document is written (by you or a writer subagent), immediately run `state-artifact` with the new file path — once per file, not once at the end. This enables crash recovery if the session is interrupted mid-suite (see shared-conventions.md \"Stage-Entry Guard\"). Add `--epic \"{epic}\"` when this feature is an epic member — required, per the Pipeline State Protocol.\n\n```bash\nR=\"$(bash -c '[ -z \"${FEATURE_FORGE_ROOT:-}\" ] || [ -x \"$FEATURE_FORGE_ROOT\u002Fscripts\u002Fforge-root.sh\" ] || { echo \"feature-forge: FEATURE_FORGE_ROOT=$FEATURE_FORGE_ROOT has no scripts\u002Fforge-root.sh\" >&2; exit 2; }; for d in \"${FEATURE_FORGE_ROOT:-}\" \"${CLAUDE_PLUGIN_ROOT:-}\" \"$HOME\"\u002F.claude\u002Fskills\u002Ffeature-forge \"$HOME\"\u002F.claude\u002Fplugins\u002Fcache\u002F*\u002Ffeature-forge\u002F* \"$HOME\"\u002F.claude\u002Fplugins\u002F*\u002Ffeature-forge \"$HOME\"\u002F.agents\u002Fskills\u002Ffeature-forge .\u002F.agents\u002Fskills\u002Ffeature-forge; do [ -x \"$d\u002Fscripts\u002Fforge-root.sh\" ] && exec \"$d\u002Fscripts\u002Fforge-root.sh\"; done')\"\n[ -n \"$R\" ] || { echo \"feature-forge: cannot locate plugin root\" >&2; exit 1; }\npython3 \"$R\u002Fscripts\u002Fforge-session.py\" state-artifact \\\n  --feature \"{feature}\" --stage forge-3-specs --path \"\u003Cfile>\" --specs-dir \"{specsDir}\"\n```\n\n## Step 4: Write the Spec Suite\n\nThe suite has a hard internal dependency: every domain\u002Fintegration doc references the\nshared types and layout from `00-core-definitions.md` and `01-architecture-layout.md`.\nSo author in two phases — a sequential foundation, then a parallel fan-out.\n\n### 4a. Foundation pass (sequential, you author)\n\nWrite `00-core-definitions.md` and `01-architecture-layout.md` yourself, in the main\nsession, **before** anything else. Every later document depends on these shared types\nand the directory\u002Fexports map, so they must exist and be stable first.\n\n### 4b. Domain fan-out (parallel `forge-spec-writer` subagents)\n\nOnce the foundation is written, dispatch the remaining numbered docs in parallel — **one\n`forge-spec-writer` subagent per document, in a single message with multiple subagent\ncalls** (the `superpowers:dispatching-parallel-agents` pattern). Each writer is given:\n- the PRD and tech-spec,\n- the just-written `00-core-definitions.md` and `01-architecture-layout.md` (so it builds\n  on the shared types, not its own),\n- the stack profile path `references\u002Fstacks\u002F{stack}.md` (if `stack` is set in config),\n- the quality bar in `references\u002Fspec-examples.md`,\n- the **exact single filename it must write** and the archetype slice (from\n  `references\u002Fspec-archetypes.md`) it covers.\n- **(epic members only — additive context):** the relevant `EPIC.md` Contracts section(s)\n  for this feature, and the `tech-spec.md` of each completed direct dependency at {paths} — so\n  the doc is written against real upstream contracts, not guesses.\n\nEach writer authors **only its one assigned file** and returns a short **manifest** of\nthe `REQ-XXX-NN` IDs it covered (feeds Step 5 traceability). Author `NN-testing-strategy.md`\nlast (it can be its own writer, or you author it once the others' shapes are known).\n\n**Fallback (no subagents available):** author the documents yourself in batches of 3–5,\nfoundation first; after each batch, optionally commit\n(`git add {specsDir}\u002F{feature}\u002F && git commit -m \"{commitPrefix}({feature}): specs batch {n}\"`)\nand re-read only `00-core-definitions.md` plus the upstream docs the next batch needs —\ndo not reload everything. This keeps quality up under context pressure.\n\n### Quality requirements (every document, whoever writes it)\n\n1. Number sequentially: `00-`, `01-`, `02-`, etc.\n2. Every implementation detail MUST trace to either a PRD requirement (REQ-XXX-NN) or a tech-spec decision\n3. Before the body, include a `## Requirement Coverage` table mapping every REQ-XXX-NN this document covers to the section that implements it\n4. Include complete type definitions, data structures, and function signatures in the project's language — not pseudocode. If a stack profile exists at `references\u002Fstacks\u002F{stack}.md` (where `{stack}` comes from `forge.config.json`), follow its conventions for type definitions, error hierarchies, and documentation comments.\n5. Include error handling for every operation\n6. Include example usage where it aids clarity\n7. Cross-reference other spec documents by filename when one document depends on definitions from another\n\n### Document Conventions\n\n- Filename format: `{specsDir}\u002F{feature}\u002F##-\u003Cdescriptive-name>.md`\n- Each document should be self-contained enough that an engineer could implement it without reading other spec docs (though cross-references help for context)\n- Include a \"Dependencies\" section listing which other spec docs must be implemented first\n- Include a \"Verification\" section describing how to confirm the implementation matches the spec\n\n## Step 5: Cross-Reference Validation\n\nBefore writing `TRACEABILITY.md` or running the stage exit, invoke the **Stage-Completion Re-check** block in `references\u002Fshared-conventions.md` with `{stage}` = `forge-3-specs` — a resumed mid-stage continuation must not overwrite a committed `TRACEABILITY.md` or re-fire a finished exit.\n\nAfter writing all documents, verify:\n\n1. Every PRD requirement has coverage in at least one spec document\n2. Every tech-spec decision is reflected in the implementation specs\n3. Cross-references between spec documents are consistent (no broken references)\n4. Type definitions used across documents are consistent\n5. No orphaned implementation details that don't trace to requirements\n6. Produce a traceability matrix: a markdown table mapping every REQ-XXX-NN from the PRD to the spec document and section that implements it. Write this to `{resolvedFeatureDir}\u002FTRACEABILITY.md`\n\nList any gaps or inconsistencies found and resolve them.\n\n## Step 6: Review with User\n\nThis is a **blocking review** — per the **Stage Review Gate** in `references\u002Fshared-conventions.md`, do not proceed until the user confirms.\n\nPresent a summary of all documents created as text, with key decisions highlighted. Then use `AskUserQuestion` to collect feedback — do NOT include these questions in your text output:\n\n\"1. Does the level of detail match what you need? 2. Any areas that need more depth? 3. Any missing subsystems or concerns?\"\n\n## Step 7: Update Pipeline State and Commit\n\nPipeline state is written by the `state-*` verbs — see the Pipeline State Protocol in `references\u002Fshared-conventions.md`.\n\n1. Record completion by running `state-complete` (below) with `--version`, one `--artifact` per created file including `TRACEABILITY.md`, and `--based-on forge-1-prd=\u003Ccurrent version> --based-on forge-2-tech=\u003Ccurrent version>`. It sets `status: \"complete\"`, `completedAt`, the version and `basedOnVersions`, and applies the downstream staleness cascade deterministically, so no downstream status is set by hand.\n2. **Offer a note — don't force one.** As a statement (not a blocking question), let the user know they can jot anything worth preserving across sessions and you'll store it in the `notes` field. If they volunteer something, store it via `state-note` — it **overwrites** the single `notes` string (latest note wins), so fold any still-relevant existing note into the one combined string; otherwise proceed. The next stage's Step 1 reads and surfaces this note.\n3. If `gitCommitAfterStage` is true, follow the Git Commit Protocol in `references\u002Fshared-conventions.md`: stage files, attempt commit with message `\"{commitPrefix}({feature}): complete implementation specs v{n}\"` (marking `stages.forge-3-specs.status` `complete` with `commitHash: null` in that commit), then record the artifact-commit hash via the protocol's two-commit follow-up (never `--amend`) only on success. If commit fails, leave status as `in-progress`.\n4. **Close with the Stage Exit Protocol** (single-sourced in `references\u002Fstage-exit-protocol.md`; do not improvise a \"Next steps\" list). Specs feed every downstream stage, so the verify gate matters here:\n\nThe `state-complete` call for item 1 — and the `state-note` call only when the user volunteered a note in item 2 — with the portable plugin-root prelude. Add `--epic \"{epic}\"` to each call when this feature is an epic member — required, per the Pipeline State Protocol in `references\u002Fshared-conventions.md`:\n\n```bash\nR=\"$(bash -c '[ -z \"${FEATURE_FORGE_ROOT:-}\" ] || [ -x \"$FEATURE_FORGE_ROOT\u002Fscripts\u002Fforge-root.sh\" ] || { echo \"feature-forge: FEATURE_FORGE_ROOT=$FEATURE_FORGE_ROOT has no scripts\u002Fforge-root.sh\" >&2; exit 2; }; for d in \"${FEATURE_FORGE_ROOT:-}\" \"${CLAUDE_PLUGIN_ROOT:-}\" \"$HOME\"\u002F.claude\u002Fskills\u002Ffeature-forge \"$HOME\"\u002F.claude\u002Fplugins\u002Fcache\u002F*\u002Ffeature-forge\u002F* \"$HOME\"\u002F.claude\u002Fplugins\u002F*\u002Ffeature-forge \"$HOME\"\u002F.agents\u002Fskills\u002Ffeature-forge .\u002F.agents\u002Fskills\u002Ffeature-forge; do [ -x \"$d\u002Fscripts\u002Fforge-root.sh\" ] && exec \"$d\u002Fscripts\u002Fforge-root.sh\"; done')\"\n[ -n \"$R\" ] || { echo \"feature-forge: cannot locate plugin root\" >&2; exit 1; }\npython3 \"$R\u002Fscripts\u002Fforge-session.py\" state-complete \\\n  --feature \"{feature}\" --stage forge-3-specs --version {n} \\\n  --based-on \"forge-1-prd=\u003Cn>\" --based-on \"forge-2-tech=\u003Cn>\" \\\n  --artifact \"\u003Cfile>\" --artifact TRACEABILITY.md --specs-dir \"{specsDir}\"\n# ONLY run the next call if the user volunteered a note in item 2 — otherwise stop here.\npython3 \"$R\u002Fscripts\u002Fforge-session.py\" state-note \\\n  --feature \"{feature}\" --note \"\u003Cwhat the user volunteered>\" --specs-dir \"{specsDir}\"\n```\n\n**Determine `--verify-capability` before running the exit** per **Host and capability determination** in `references\u002Fstage-exit-protocol.md` (summarized under **Verify Capability** in `references\u002Fshared-conventions.md`): pass `interactive` only when a question mechanism equivalent to `AskUserQuestion` is available **and** dispatching a clean-room `forge-verifier` is *permitted* (the test is \"may I dispatch right now\", not tool presence) — otherwise `manual`. That reference owns the full rule, including why a consent-only bar is still `interactive` and the `none`-gate consent variant. Add `--epic \"{epic}\"` to the call below when this feature is an epic member.\n\n**Close this stage with the Scripted Stage Exit** (contract: `references\u002Fstage-exit-protocol.md`; do not improvise a \"Next steps\" list). Run:\n\n```bash\nR=\"$(bash -c '[ -z \"${FEATURE_FORGE_ROOT:-}\" ] || [ -x \"$FEATURE_FORGE_ROOT\u002Fscripts\u002Fforge-root.sh\" ] || { echo \"feature-forge: FEATURE_FORGE_ROOT=$FEATURE_FORGE_ROOT has no scripts\u002Fforge-root.sh\" >&2; exit 2; }; for d in \"${FEATURE_FORGE_ROOT:-}\" \"${CLAUDE_PLUGIN_ROOT:-}\" \"$HOME\"\u002F.claude\u002Fskills\u002Ffeature-forge \"$HOME\"\u002F.claude\u002Fplugins\u002Fcache\u002F*\u002Ffeature-forge\u002F* \"$HOME\"\u002F.claude\u002Fplugins\u002F*\u002Ffeature-forge \"$HOME\"\u002F.agents\u002Fskills\u002Ffeature-forge .\u002F.agents\u002Fskills\u002Ffeature-forge; do [ -x \"$d\u002Fscripts\u002Fforge-root.sh\" ] && exec \"$d\u002Fscripts\u002Fforge-root.sh\"; done')\"\n[ -n \"$R\" ] || { echo \"feature-forge: cannot locate plugin root\" >&2; exit 1; }\npython3 \"$R\u002Fscripts\u002Fforge-session.py\" stage-exit --feature \"{feature}\" --stage forge-3-specs --specs-dir \"{specsDir}\" --host pi --verify-capability \"{verify-capability}\"\n```\n\nObey the DIRECTIVES it prints, in the consumption order this protocol fixes: surface `invalidAutoVerifyKeys` and every `warnings` entry first; `runInStageVerify: true` → run the in-stage clean-room verify chain now (honoring `autoFixEligible`, and asking through the Standard Verify Gate first when you may not dispatch unsolicited); `verifyGate: \"standard\"` → present the Standard Verify Gate; `verifyGate: \"manual-print\"` → print the `verifyCommand` for the user and do **not** dispatch inline. Then, and only when `terminalOwnedBy` is `\"self\"`, **print the NEXT-STEPS block verbatim as your absolute last output — nothing after its sentinel line.** A `terminalOwnedBy: \"outer\"` payload carries `nextSteps: null`: return your structured result to the caller and print no terminal block at all.\n\n## Gotchas\n\n- Don't create specs for things that are already fully specified in the tech spec. If the tech spec has complete type definitions, the implementation spec should reference them, not duplicate them.\n- Every spec document should include complete type definitions and function signatures in the project's language with documentation comments. The backlog generator and implementing engineer depend on these being exact, not approximate.\n- Resist the urge to create too many documents. Each document should represent a major concern. If a \"document\" would be under 50 lines, it probably belongs as a section in another document.\n- Watch for implicit dependencies between subsystems. If subsystem A's types are used by subsystem B, the spec should explicitly state this and ensure the types are defined in the shared types document.\n- If the feature is large, the spec suite might be 8-12 documents. If it's simple, 3-4 is fine. Match complexity to the feature, not a fixed template.\n\n---\n\n## Host execution notes (Pi)\n\nThis Pi bundle preserves Claude's `AskUserQuestion` references because it ships a Pi compatibility extension registering an `AskUserQuestion` tool. On Pi:\n\n- **User input:** use `AskUserQuestion` for genuine user decisions. It supports multiple questions, option descriptions, recommended ordering, multi-select, previews, and free-form Other\u002Fcustom answers.\n- **Non-interactive (`-p`\u002F`--mode json`):** `AskUserQuestion` is stripped from the tool list, so its absence alone cannot tell you the rung — read that from the Interaction Capability Ladder's `interaction-mode` record. A call attempted anyway fails with `Error: UI not available (running in non-interactive mode)` — never read that as a decline. Take the Interaction Capability Ladder's declared conservative default, state it in your output, and use `no-default: abort — \u003Cquestion> requires a human answer` for an interview question with no sane default (`references\u002Fshared-conventions.md`).\n- **Skill dispatch:** Pi uses `\u002Fskill:\u003Cname>` commands. If you cannot invoke a skill directly, print the exact `\u002Fskill:\u003Cname> ...` command for the user to run. A **forge-invocation-args** compatibility extension wraps the arguments of a `\u002Fskill:forge-*` command in a `\u003Cfeature-forge-invocation>` envelope before Pi expands it, so read the feature name from that envelope's `\u003Carguments>` element (an empty element means none was supplied) rather than from unlabeled trailing text — see `references\u002Fshared-conventions.md` § Feature Name Requirement.\n- **Subagents:** this bundle declares its custom agents (`forge-researcher`, `forge-spec-writer`, `forge-verifier`) as package agents. If a `subagent` tool is registered, dispatch one with `{ agent: \"forge-verifier\", task: \"...\" }`, or fan several out concurrently with `{ tasks: [{ agent: \"forge-spec-writer\", task: \"...\" }, ...] }`. If no `subagent` tool is available, run that step inline yourself.\n- **Background \u002F monitoring (forge-5-loop):** run the loop through **rauf's Pi package** (`pi install npm:@garygentry\u002Frauf`, rauf >= 0.18.0), whose `rauf-loop-supervisor` extension registers `rauf_loop_launch`, `rauf_loop_status`, `rauf_loop_wait` and `rauf_loop_stop`. Launch with `rauf_loop_launch`; it starts the loop **detached** (it outlives this session), posts a one-line card per completed item, and **wakes this session** on needs-human, blocked, stuck, review failure, loop errors and completion — so end your turn after the launch: do not poll, sleep, tail, run the loop in the foreground or behind `nohup`\u002F`&`, or hand it to a subagent (the extension blocks those calls). Read `rauf_loop_status` before acting on a wake; use `rauf_loop_stop` only to deliberately stop the runner. Full detail: `references\u002Frunner-contract.md` Steps 3b\u002F3d. If the `rauf_loop_*` tools are not registered, `forge-session.py doctor` says how to install the package; until then use the `rauf loop wait` recipe there.\n",{"name":5,"description":7},"main","ce0d6d40bba1d87039b0397041d15cb56c934037","adapters\u002Fpi\u002Fskills\u002Fforge-3-specs","https:\u002F\u002Fgithub.com\u002Fgarygentry\u002Ffeature-forge","https:\u002F\u002Fgarygentry.github.io\u002Ffeature-forge\u002F","https:\u002F\u002Fgithub.com\u002Fgarygentry","2026-10-15 10:14:13",{"source":8,"skillName":5,"commands":31,"prompt":41,"zipAvailable":42},[32,35,38],{"tool":33,"command":34},"npx","npx skills add garygentry\u002Ffeature-forge --skill forge-3-specs",{"tool":36,"command":37},"bunx","bunx skills add garygentry\u002Ffeature-forge --skill forge-3-specs",{"tool":39,"command":40},"pnpm","pnpm dlx skills add garygentry\u002Ffeature-forge --skill forge-3-specs","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fgarygentry\u002Ffeature-forge\u002Fblob\u002Fmain\u002Fadapters\u002Fpi\u002Fskills\u002Fforge-3-specs\u002FSKILL.md",true,[44,50,54,58,62,66,70,74,78],{"path":45,"resourceType":46,"resourceTypeDesc":47,"sizeBytes":48,"sourceHtmlUrl":49},"references\u002Fshared-conventions.md","REFERENCE","参考文档",73992,"https:\u002F\u002Fgithub.com\u002Fgarygentry\u002Ffeature-forge\u002Fblob\u002Fmain\u002Fadapters\u002Fpi\u002Fskills\u002Fforge-3-specs\u002Freferences\u002Fshared-conventions.md",{"path":51,"resourceType":46,"resourceTypeDesc":47,"sizeBytes":52,"sourceHtmlUrl":53},"references\u002Fspec-archetypes.md",4884,"https:\u002F\u002Fgithub.com\u002Fgarygentry\u002Ffeature-forge\u002Fblob\u002Fmain\u002Fadapters\u002Fpi\u002Fskills\u002Fforge-3-specs\u002Freferences\u002Fspec-archetypes.md",{"path":55,"resourceType":46,"resourceTypeDesc":47,"sizeBytes":56,"sourceHtmlUrl":57},"references\u002Fspec-examples.md",3104,"https:\u002F\u002Fgithub.com\u002Fgarygentry\u002Ffeature-forge\u002Fblob\u002Fmain\u002Fadapters\u002Fpi\u002Fskills\u002Fforge-3-specs\u002Freferences\u002Fspec-examples.md",{"path":59,"resourceType":46,"resourceTypeDesc":47,"sizeBytes":60,"sourceHtmlUrl":61},"references\u002Fstacks\u002F_generic.md",5709,"https:\u002F\u002Fgithub.com\u002Fgarygentry\u002Ffeature-forge\u002Fblob\u002Fmain\u002Fadapters\u002Fpi\u002Fskills\u002Fforge-3-specs\u002Freferences\u002Fstacks\u002F_generic.md",{"path":63,"resourceType":46,"resourceTypeDesc":47,"sizeBytes":64,"sourceHtmlUrl":65},"references\u002Fstacks\u002Fgo.md",8684,"https:\u002F\u002Fgithub.com\u002Fgarygentry\u002Ffeature-forge\u002Fblob\u002Fmain\u002Fadapters\u002Fpi\u002Fskills\u002Fforge-3-specs\u002Freferences\u002Fstacks\u002Fgo.md",{"path":67,"resourceType":46,"resourceTypeDesc":47,"sizeBytes":68,"sourceHtmlUrl":69},"references\u002Fstacks\u002Fpython.md",8212,"https:\u002F\u002Fgithub.com\u002Fgarygentry\u002Ffeature-forge\u002Fblob\u002Fmain\u002Fadapters\u002Fpi\u002Fskills\u002Fforge-3-specs\u002Freferences\u002Fstacks\u002Fpython.md",{"path":71,"resourceType":46,"resourceTypeDesc":47,"sizeBytes":72,"sourceHtmlUrl":73},"references\u002Fstacks\u002Frust.md",9621,"https:\u002F\u002Fgithub.com\u002Fgarygentry\u002Ffeature-forge\u002Fblob\u002Fmain\u002Fadapters\u002Fpi\u002Fskills\u002Fforge-3-specs\u002Freferences\u002Fstacks\u002Frust.md",{"path":75,"resourceType":46,"resourceTypeDesc":47,"sizeBytes":76,"sourceHtmlUrl":77},"references\u002Fstacks\u002Ftypescript.md",6648,"https:\u002F\u002Fgithub.com\u002Fgarygentry\u002Ffeature-forge\u002Fblob\u002Fmain\u002Fadapters\u002Fpi\u002Fskills\u002Fforge-3-specs\u002Freferences\u002Fstacks\u002Ftypescript.md",{"path":79,"resourceType":46,"resourceTypeDesc":47,"sizeBytes":80,"sourceHtmlUrl":81},"references\u002Fstage-exit-protocol.md",35623,"https:\u002F\u002Fgithub.com\u002Fgarygentry\u002Ffeature-forge\u002Fblob\u002Fmain\u002Fadapters\u002Fpi\u002Fskills\u002Fforge-3-specs\u002Freferences\u002Fstage-exit-protocol.md",[83,90,95,101,106,112],{"skillNo":84,"name":85,"nameZh":6,"description":86,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":87,"categories":88,"keywords":89,"publishedAt":18},"01M75H8RTWSJ2HYCPPKA3FRG42","alpha","A valid skill description.","https:\u002F\u002Fgithub.com\u002Fgarygentry\u002Ffeature-forge\u002Fblob\u002Fmain\u002Ftests\u002Ffixtures\u002Freader-nested-metadata\u002Fskills\u002Falpha\u002FSKILL.md",[],[],{"skillNo":91,"name":85,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":92,"categories":93,"keywords":94,"publishedAt":18},"01M75H8QXKFS116EF1009KB3CY","https:\u002F\u002Fgithub.com\u002Fgarygentry\u002Ffeature-forge\u002Fblob\u002Fmain\u002Ftests\u002Ffixtures\u002Freader-malformed\u002Fskills\u002Falpha\u002FSKILL.md",[],[],{"skillNo":96,"name":85,"nameZh":6,"description":97,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":98,"categories":99,"keywords":100,"publishedAt":18},"01M75H8PKNSV4WEREK6D91G9T4","This is a folded scalar description.","https:\u002F\u002Fgithub.com\u002Fgarygentry\u002Ffeature-forge\u002Fblob\u002Fmain\u002Ftests\u002Ffixtures\u002Freader-folded-scalar\u002Fskills\u002Falpha\u002FSKILL.md",[],[],{"skillNo":102,"name":85,"nameZh":6,"description":86,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":103,"categories":104,"keywords":105,"publishedAt":18},"01M75H8MAV261C8QJ4S8CGRHV5","https:\u002F\u002Fgithub.com\u002Fgarygentry\u002Ffeature-forge\u002Fblob\u002Fmain\u002Ftests\u002Ffixtures\u002Freader-crlf\u002Fskills\u002Falpha\u002FSKILL.md",[],[],{"skillNo":107,"name":85,"nameZh":6,"description":108,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":109,"categories":110,"keywords":111,"publishedAt":18},"01M75H8KDW98YF0PBHPD5V1GKR","foo: bar","https:\u002F\u002Fgithub.com\u002Fgarygentry\u002Ffeature-forge\u002Fblob\u002Fmain\u002Ftests\u002Ffixtures\u002Freader-colon-value\u002Fskills\u002Falpha\u002FSKILL.md",[],[],{"skillNo":113,"name":85,"nameZh":6,"description":114,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":115,"categories":116,"keywords":117,"publishedAt":18},"01M75H8JFYFCGYNRCRTS4PMKKX","A valid description.","https:\u002F\u002Fgithub.com\u002Fgarygentry\u002Ffeature-forge\u002Fblob\u002Fmain\u002Ftests\u002Ffixtures\u002Freader-blank-lines\u002Fskills\u002Falpha\u002FSKILL.md",[],[]]