bmad-module-skill-forge 1.8.0 → 1.9.0

package/.claude-plugin/marketplace.json

@@ -30,7 +30,7 @@
       "name": "skill-forge",
       "source": "./",
       "description": "Evidence-based agent skills compiler with progressive capability tiers (Quick/Forge/Forge+/Deep).",
-      "version": "1.8.0",
+      "version": "1.9.0",
       "author": {
         "name": "Armel"
       },

package/docs/_data/pinned.yaml

@@ -26,7 +26,7 @@
 # Enforced two ways: (1) release.yaml bumps this line in the same commit
 # as package.json + marketplace.json on every release; (2) validate-docs-drift.js
 # cross-checks this value against package.json.version and fails on mismatch.
-skf_version: "1.8.0"
+skf_version: "1.9.0"
 
 # Path to the oh-my-skills repo, resolved relative to this repo's root.
 # Override at runtime with the OMS environment variable if oh-my-skills

package/docs/bmad-synergy.md

@@ -25,6 +25,22 @@ When a BMAD agent runs a workflow, that workflow can consult SKF content skills
 
 ---
 
+## SKF Without BMM
+
+SKF works standalone — no BMAD installation required. If you found this page from a search and don't use the BMAD Method, this section is for you.
+
+The fastest way to start is [`deepwiki`](../deepwiki/). One command produces a verified wiki skill in 3–5 minutes with zero configuration:
+
+```
+@Ferris deepwiki https://github.com/honojs/hono
+```
+
+That's it. No brief file, no scope decisions, no multi-step pipeline to learn. deepwiki handles analysis, scoping, compilation, testing (with a 90% quality gate), and export automatically. See the [deepwiki guide](../deepwiki/) for the full syntax and input types.
+
+If you later adopt the BMAD Method, the skills you created via deepwiki integrate seamlessly into BMM phases — they become the verified content skills that BMAD workflows consult during planning and implementation. The [phase-by-phase playbook](#skf-and-bmm-phase-by-phase-playbook) below shows exactly where each SKF workflow fits.
+
+---
+
 ## SKF and BMM: Phase-by-Phase Playbook
 
 BMM is BMAD's core [4-phase workflow](https://docs.bmad-method.org/) (Analysis → Planning → Solutioning → Implementation). SKF has five concrete entry points across those phases. The diagram below shows the end-to-end picture; the subsections that follow give the trigger, command, and artifact flow for each phase.

package/docs/deepwiki.md

@@ -0,0 +1,89 @@
+---
+title: deepwiki
+description: Zero-ceremony wiki-skill creation — one command turns a GitHub repo, doc URL, or pinned version into a verified wiki skill
+---
+
+deepwiki is a [pipeline alias](../workflows/#pipeline-aliases) that chains five workflows into a single command. Give it a repo URL, a documentation URL, or a pinned version, and it produces a verified wiki skill in 3–5 minutes with zero configuration.
+
+If you're new to SKF and want to try it without reading anything else, start here.
+
+---
+
+## Invocation
+
+Three input types, one command pattern:
+
+```
+@Ferris deepwiki https://github.com/honojs/hono                  — repo URL
+@Ferris deepwiki https://docs.example.com                         — doc URL (docs-only)
+@Ferris deepwiki https://github.com/honojs/hono --pin v4.6.0      — pinned version
+```
+
+- **Repo URL** — analyzes the full source repository, extracts exports, and compiles a wiki skill from code + docs.
+- **Doc URL** — skips source analysis entirely and builds the skill from documentation alone. Useful for closed-source libraries or when the docs are the canonical reference.
+- **`--pin <version>`** — targets a specific release. The version tag is resolved during analysis so the resulting skill is locked to that exact API surface.
+
+---
+
+## Pipeline Stages
+
+deepwiki expands to `AN[auto] BS[auto] CS TS[min:90] EX`. Each stage runs in [headless mode](../workflows/#headless-mode) — no confirmation gates, no interactive prompts.
+
+| Stage | Workflow | Mode | What Happens |
+|-------|----------|------|-------------|
+| 1 | **Analyze Source** (AN) | `[auto]` | Scans the target, detects shape (library/framework/tool/app), discovers exports, and generates a scope + brief automatically. |
+| 2 | **Brief Skill** (BS) | `[auto]` | Enriches the auto-generated brief with doc detection results. No interactive scoping — the brief is assembled from AN's output. |
+| 3 | **Create Skill** (CS) | standard | Compiles the skill from the enriched brief. Extracts exports, resolves documentation sources, validates structure. |
+| 4 | **Test Skill** (TS) | `[min:90]` | Verifies completeness with a **90% quality threshold** (stricter than the default 80%). Fail halts the pipeline. |
+| 5 | **Export Skill** (EX) | standard | Validates the package, generates context snippets, and injects into your IDE's context file. |
+
+Data flows automatically between stages — the brief path from AN feeds BS, the skill name from CS feeds TS, and so on. See [Pipeline Mode](../workflows/#pipeline-mode) for the general mechanics.
+
+---
+
+## Automatic Behaviors
+
+deepwiki's `[auto]` flags activate several behaviors that normally require manual input:
+
+- **Auto-scope** — shape detection (library, framework, tool, application) drives scope decisions. No interactive scope confirmation.
+- **Auto-brief** — the brief is generated and enriched with doc-detection results in one pass, without the interactive discovery flow that `BS` uses standalone.
+- **Coexistence detection** — if a skill for the same target already exists, deepwiki detects it and offers three options: create alongside (new version), merge into the existing skill, or skip.
+- **Auto-decomposition** — for massive repos (>500 exports or >3 packages), AN automatically decomposes into multiple analysis units before proceeding.
+
+---
+
+## Expected Output
+
+A successful deepwiki run produces a complete skill package in your forge data directory, exported and ready for use. The skill includes:
+
+- `SKILL.md` — the compiled wiki skill with provenance-cited instructions
+- `metadata.json` — version, source, confidence tier breakdown
+- Context snippet injected into your IDE context file (CLAUDE.md, .cursorrules, AGENTS.md, etc.)
+
+The quality threshold is 90% — if the skill scores below that, the pipeline halts at TS with a gap report. Run `@Ferris US` to address gaps, then `@Ferris TS EX` to re-test and export.
+
+---
+
+## Timing
+
+A typical library (50–200 exports) takes **3–5 minutes** end to end. Factors that increase time:
+
+- Massive repos (>500 exports) trigger auto-decomposition, adding 1–3 minutes
+- Doc-only targets depend on documentation site size and structure
+- Deep-tier projects (with QMD and CCC) spend more time on enrichment
+
+---
+
+## Migration from onboard
+
+deepwiki replaces the older `onboard` alias. `onboard` still works but shows a deprecation notice on every invocation and will be removed in v2.0.
+
+The key difference: `onboard` runs `AN CS TS EX` with standard (interactive) modes. deepwiki adds auto-scope, auto-brief, a stricter quality gate (90% vs 80%), and accepts repo URLs and doc URLs — not just project paths.
+
+---
+
+## Related
+
+- [Workflows](../workflows/) — pipeline mode mechanics, headless mode, circuit breakers
+- [Concepts](../concepts/) — provenance, confidence tiers, drift, version pinning
+- [BMAD Synergy](../bmad-synergy/) — how deepwiki fits into BMAD phases, and standalone SKF usage

package/docs/verifying-a-skill.md

@@ -156,16 +156,22 @@ Your forge tier determines which categories can be scored:
 
 When categories are skipped, their combined weight is redistributed proportionally to the remaining active categories. A Quick-tier skill and a Deep-tier skill both pass at the same 80% threshold — the score reflects what your tier can actually measure.
 
+### Hard gate
+
+Before scoring, a hard gate scans all findings for **Critical** and **High** severity. If any are present, the pipeline blocks immediately — no score is computed and the skill cannot pass regardless of coverage percentage. Medium, Low, and Info findings pass through to scoring.
+
 ### Pass/fail
 
 ```
-threshold = custom_threshold OR 80% (default)
+threshold = pipeline_default OR custom_threshold OR 80% (default)
 
 score >= threshold  →  PASS  →  Recommend export-skill
 score <  threshold  →  FAIL  →  Recommend update-skill
 ```
 
-The default is 80%. You can override it by specifying a custom threshold when invoking the workflow (e.g., "test this skill with a 70% threshold").
+The default threshold is **80%**. Pipeline aliases declare their own defaults: `deepwiki` targets **90%**, `forge` and `forge-quick` target **80%**. You can override any default with a custom threshold (e.g., `TS[min:85]`).
+
+When a skill scores between 80% and its target threshold (e.g., 82% against a 90% target), the soft gate falls back to the 80% floor — the skill passes, but an evidence report is written to `forge-data/{skill}/{version}/evidence-report-fallback.md` documenting the quality compromise.
 
 ### Gap severities
 

package/docs/workflows.md

@@ -52,7 +52,7 @@ Trigger workflows by typing commands to [Ferris](../agents/). See [Concepts](../
 
 **When to Use:** After Brief Skill, or with an existing skill-brief.yaml.
 
-**Key Steps:** Load brief → Ecosystem check → Extract (AST + scripts/assets) → QMD enrich (Deep) → Compile → Validate → Generate
+**Key Steps:** Load brief → Ecosystem check → Extract (AST + scripts/assets) → QMD enrich (Deep) → Compile → Doc sources → Auto-shard → Doc-rot → Validate → Generate
 
 **Agent:** Ferris (Architect mode)
 
@@ -141,7 +141,7 @@ Trigger workflows by typing commands to [Ferris](../agents/). See [Concepts](../
 
 **When to Use:** To check if a skill has fallen out of date with its source code. Works for both individual skills and stack skills.
 
-**Key Steps:** Load skill → Re-index source → Structural diff (incl. script/asset drift) → Semantic diff (Deep) → Classify severity → Report
+**Key Steps:** Load skill → Re-index source → Structural diff (incl. script/asset drift) → Semantic diff (Deep) → Classify severity → Doc drift → Report
 
 **Stack skill support:** Code-mode stacks are audited per-library against their sources. Compose-mode stacks check constituent freshness via metadata hash comparison — if a constituent skill was updated after the stack was composed, audit flags it as constituent drift. Stack skills that need updating are redirected to `@Ferris SS` for re-composition (surgical update is not supported for stacks).
 
@@ -157,9 +157,9 @@ Trigger workflows by typing commands to [Ferris](../agents/). See [Concepts](../
 
 **When to Use:** After creating or updating a skill, before exporting.
 
-**Key Steps:** Load skill → Detect mode → Coverage check → Coherence check → External validation (skill-check, tessl) → Score → Gap report
+**Key Steps:** Load skill → Detect mode → Coverage check → Coherence check → External validation (skill-check, tessl) → Hard gate → Score → Gap report
 
-**Scored Categories:** Export Coverage (36%), Signature Accuracy (22%), Type Coverage (14%), Coherence (18%), External Validation (10%). Default pass threshold: **80%**. Pass routes to Export Skill; fail routes to Update Skill with a gap report. See [Completeness Scoring](../verifying-a-skill/#how-the-score-is-computed) for the full formula and tier adjustments.
+**Scored Categories:** Export Coverage (36%), Signature Accuracy (22%), Type Coverage (14%), Coherence (18%), External Validation (10%). Default pass threshold: **80%** (per-pipeline defaults: deepwiki 90%, forge 80%). Pass routes to Export Skill; fail routes to Update Skill with a gap report. See [Completeness Scoring](../verifying-a-skill/#how-the-score-is-computed) for the full formula and tier adjustments.
 
 **Agent:** Ferris (Audit mode)
 
@@ -289,7 +289,7 @@ flowchart TD
 | Category                  | Workflows      | Description                                                                                                                      |
 | ------------------------- | -------------- | -------------------------------------------------------------------------------------------------------------------------------- |
 | Core                      | SF, BS, CS, US | Setup, brief, create, and update skills                                                                                          |
-| Feature                   | QS, SS, AN     | Quick skill, stack skill, and analyze source                                                                                     |
+| Feature                   | QS, SS, AN     | Quick skill, stack skill, and analyze source — the [`deepwiki`](#pipeline-aliases) alias chains AN + BS + CS + TS + EX for zero-ceremony wiki-skill creation |
 | Quality                   | AS, TS         | Detect skill drift (AS) and verify skill completeness (TS)                                                                       |
 | Architecture Verification | VS, RA         | Pre-code architecture feasibility and refinement                                                                                 |
 | Management                | RS, DS         | Rename and drop skill versions with transactional safety                                                                         |
@@ -313,12 +313,15 @@ Instead of running one workflow per session, you can chain multiple workflows in
 
 ### Pipeline Aliases
 
-| Alias         | Expands To    | First Workflow | Required Target                              |
-| ------------- | ------------- | -------------- | -------------------------------------------- |
-| `forge`       | `BS CS TS EX` | BS             | GitHub URL or local path **+** skill name    |
-| `forge-quick` | `QS TS EX`    | QS             | GitHub URL **or** package name               |
-| `onboard`     | `AN CS TS EX` | AN             | Project path (defaults to current directory) |
-| `maintain`    | `AS US TS EX` | AS             | Existing skill name                          |
+The `deepwiki` alias is the recommended way to create wiki skills — one command, zero configuration. It chains five workflows with auto-mode flags so you get a verified skill without touching a brief or scope file.
+
+| Alias         | Expands To                             | First Workflow | Required Target                              |
+| ------------- | -------------------------------------- | -------------- | -------------------------------------------- |
+| `deepwiki`    | `AN[auto] BS[auto] CS TS[min:90] EX`  | AN             | GitHub URL, doc URL, or `--pin <version>`    |
+| `forge`       | `BS CS TS EX`                          | BS             | GitHub URL or local path **+** skill name    |
+| `forge-quick` | `QS TS EX`                            | QS             | GitHub URL **or** package name               |
+| `onboard`     | `AN CS TS EX` *(deprecated — use deepwiki)* | AN        | Project path (defaults to current directory) |
+| `maintain`    | `AS US TS EX`                          | AS             | Existing skill name                          |
 
 **The first workflow's input contract defines what arguments the pipeline needs.** A bare package name works for `forge-quick` (QS resolves packages via the registry) but **not** for `forge` — BS requires both an unambiguous target (URL or path) and a skill name.
 
@@ -334,6 +337,9 @@ Instead of running one workflow per session, you can chain multiple workflows in
 ### Examples
 
 ```
+@Ferris deepwiki https://github.com/honojs/hono                     — zero-ceremony wiki skill
+@Ferris deepwiki https://docs.example.com                            — docs-only wiki skill
+@Ferris deepwiki https://github.com/honojs/hono --pin v4.6.0         — pinned version
 @Ferris forge-quick @tanstack/query                                  — QS + TS + EX for TanStack Query
 @Ferris forge https://github.com/topoteretes/cognee cognee           — BS + CS + TS + EX, explicit URL + name
 @Ferris forge https://github.com/topoteretes/cognee cognee "public API only"   — with scope hint

package/package.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/package.json",
   "name": "bmad-module-skill-forge",
-  "version": "1.8.0",
+  "version": "1.9.0",
   "description": "BMAD module — Turn code and docs into instructions AI agents can actually follow. Progressive capability tiers (Quick/Forge/Forge+/Deep).",
   "keywords": [
     "bmad",
@@ -53,7 +53,7 @@
     "test:cli": "node test/test-cli-integration.js",
     "test:install": "node test/test-installation-components.js",
     "test:knowledge": "node test/test-knowledge-base.js",
-    "test:python": "uv run --with pytest --with pyyaml --with jsonschema pytest test/test-compute-score-contract.py test/test-skf-preflight.py test/test-skf-skill-inventory.py test/test-skf-validate-output.py test/test-skf-validate-frontmatter.py test/test-skf-manifest-ops.py test/test-skf-rebuild-managed-sections.py test/test-skf-atomic-write.py test/test-skf-severity-classify.py test/test-skf-structural-diff.py test/test-skf-detect-tools.py test/test-skf-forge-tier-rw.py test/test-skf-emit-result-envelope.py test/test-skf-qmd-classify-collections.py test/test-skf-merge-ccc-exclusions.py test/test-skf-resolve-package.py test/test-skf-extract-public-api.py test/test-skf-render-quick-metadata.py test/test-skf-validate-brief-inputs.py test/test-skf-emit-brief-result-envelope.py test/test-skf-write-skill-brief.py test/test-skf-detect-workspaces.py test/test-skf-recommend-scope-type.py test/test-skf-detect-language.py test/test-skf-description-guard.py test/test-skf-detect-scripts-assets.py test/test-skf-hash-content.py test/test-skf-validate-brief-schema.py test/test-skf-check-workspace-drift.py test/test-skf-update-active-symlink.py test/test-skf-build-change-manifest.py test/test-skf-provenance-gap-dispatch.py test/test-skf-resolve-authoritative-files.py test/test-skf-scan-manifests.py test/test-skf-pair-intersect.py test/test-skf-enumerate-stack-skills.py test/test-skf-compare-file-hashes.py test/test-skf-load-provenance.py test/test-skf-scan-skill-md-structure.py test/test-skf-disqualify-candidates.py test/test-skf-chain-reachability.py -v",
+    "test:python": "uv run --with pytest --with pyyaml --with jsonschema pytest test/test-compute-score-contract.py test/test-skf-preflight.py test/test-skf-skill-inventory.py test/test-skf-validate-output.py test/test-skf-validate-frontmatter.py test/test-skf-manifest-ops.py test/test-skf-rebuild-managed-sections.py test/test-skf-atomic-write.py test/test-skf-severity-classify.py test/test-skf-structural-diff.py test/test-skf-detect-tools.py test/test-skf-forge-tier-rw.py test/test-skf-emit-result-envelope.py test/test-skf-qmd-classify-collections.py test/test-skf-merge-ccc-exclusions.py test/test-skf-resolve-package.py test/test-skf-extract-public-api.py test/test-skf-render-quick-metadata.py test/test-skf-validate-brief-inputs.py test/test-skf-emit-brief-result-envelope.py test/test-skf-write-skill-brief.py test/test-skf-detect-workspaces.py test/test-skf-recommend-scope-type.py test/test-skf-detect-language.py test/test-skf-description-guard.py test/test-skf-detect-scripts-assets.py test/test-skf-hash-content.py test/test-skf-validate-brief-schema.py test/test-skf-check-workspace-drift.py test/test-skf-update-active-symlink.py test/test-skf-build-change-manifest.py test/test-skf-provenance-gap-dispatch.py test/test-skf-resolve-authoritative-files.py test/test-skf-scan-manifests.py test/test-skf-pair-intersect.py test/test-skf-enumerate-stack-skills.py test/test-skf-compare-file-hashes.py test/test-skf-load-provenance.py test/test-skf-scan-skill-md-structure.py test/test-skf-disqualify-candidates.py test/test-skf-chain-reachability.py test/test-skf-shape-detect.py test/test-skf-detect-docs.py test/test-skf-step-doc-sources.py test/test-skf-step-doc-drift.py test/test-skf-step-hard-gate.py test/test-skf-per-pipeline-thresholds.py test/test-skf-evidence-report-fallback.py test/test-skf-validate-pins.py test/test-skf-auto-shard.py test/test-skf-preapply.py test/test-skf-step-doc-rot.py -v",
     "test:schemas": "node test/test-agent-schema.js",
     "test:workflow": "node test/test-workflow-state.js",
     "validate:refs": "node tools/validate-file-refs.js --strict",

package/src/shared/_known-workarounds.yaml

@@ -0,0 +1,155 @@
+version: 1
+workarounds:
+  - fingerprint: "```api\nGET /api/v1/skills/compile"
+    fix: "```\nskf compile --target <skill-dir>"
+    source: gmc-batch-2024-q4
+    severity: high
+    description: Hallucinated REST API endpoint replaced with correct CLI invocation
+
+  - fingerprint: 'requires-python = ">=3.8"'
+    fix: 'requires-python = ">=3.9"'
+    source: gmc-batch-2024-q4
+    severity: medium
+    description: Stale Python 3.8 minimum version updated to 3.9 baseline
+
+  - fingerprint: "## outputs\n\n## steps"
+    fix: "## Outputs\n\n## Steps"
+    source: gmc-batch-2025-q1
+    severity: high
+    description: Lowercase heading violates skill-sections spec capitalization rules
+
+  - fingerprint: "confidence: unverified"
+    fix: "confidence: T1-inferred"
+    source: gmc-batch-2025-q1
+    severity: medium
+    description: Missing provenance tier replaced with correct T1 annotation
+
+  - fingerprint: "[source: unknown]"
+    fix: "[source: repo-readme]"
+    source: gmc-batch-2024-q4
+    severity: low
+    description: Placeholder source attribution replaced with actual provenance
+
+  - fingerprint: "See [API Reference](./api-reference.md)"
+    fix: "See the API reference in the repository documentation."
+    source: gmc-batch-2025-q1
+    severity: high
+    description: Broken cross-reference to non-existent api-reference.md file
+
+  - fingerprint: "## Steps\n## Outputs"
+    fix: "## Steps\n\n## Outputs"
+    source: gmc-batch-2024-q4
+    severity: low
+    description: Missing blank line between heading sections fails markdown lint
+
+  - fingerprint: "(v1.0.0+)"
+    fix: ""
+    source: gmc-batch-2025-q1
+    severity: low
+    description: Inline version stamp removed per documentation conventions
+
+  - fingerprint: "tier: gold"
+    fix: "tier: verified"
+    source: gmc-batch-2024-q4
+    severity: medium
+    description: Non-standard tier label replaced with canonical tier vocabulary
+
+  - fingerprint: "```javascript\nfetch('/api/skill"
+    fix: "```bash\nskf"
+    source: gmc-batch-2025-q1
+    severity: high
+    description: Hallucinated JavaScript fetch call replaced with CLI command
+
+  - fingerprint: "## References\n## Steps"
+    fix: "## Steps"
+    source: gmc-batch-2024-q4
+    severity: high
+    description: References section misplaced before Steps violates section ordering
+
+  - fingerprint: "source: (generated)"
+    fix: "source: compilation-output"
+    source: gmc-batch-2025-q1
+    severity: low
+    description: Vague generated marker replaced with specific compilation-output source
+
+  - fingerprint: "# Skill Name\n# Overview"
+    fix: "# Skill Name\n\n## Overview"
+    source: gmc-batch-2024-q4
+    severity: high
+    description: Duplicate H1 heading replaced with correct H2 for Overview section
+
+  - fingerprint: "[ref: SKILL-SPEC-2.0](./spec.md)"
+    fix: "See the skill specification."
+    source: gmc-batch-2025-q1
+    severity: medium
+    description: Broken spec reference link to non-existent file
+
+  - fingerprint: "version: 0.9-draft"
+    fix: "version: 1"
+    source: gmc-batch-2024-q4
+    severity: medium
+    description: Draft version string replaced with release version
+
+  - fingerprint: "\\bconfidence:\\s*(?:none|n/a|unset)\\b"
+    fix: "confidence: T1-inferred"
+    source: gmc-batch-2025-q1
+    severity: medium
+    description: Empty or null confidence values normalized to T1-inferred
+    regex: true
+
+  - fingerprint: "  - tool: compile-skill\n    endpoint: /compile"
+    fix: "  - tool: skf-compile\n    invocation: CLI"
+    source: gmc-batch-2024-q4
+    severity: high
+    description: Hallucinated tool entry with REST endpoint replaced with correct CLI tool
+
+  - fingerprint: "## setup\n"
+    fix: "## Setup\n"
+    source: gmc-batch-2025-q1
+    severity: low
+    description: Lowercase Setup heading fails skill-check validation
+
+  - fingerprint: "\\[citation needed\\]"
+    fix: ""
+    source: gmc-batch-2024-q4
+    severity: low
+    description: Wikipedia-style citation placeholder removed from compiled output
+    regex: true
+
+  - fingerprint: "Last updated: 2023"
+    fix: ""
+    source: gmc-batch-2025-q1
+    severity: low
+    description: Stale 2023 date stamp removed from compiled skill content
+
+  - fingerprint: "## Inputs\n## inputs"
+    fix: "## Inputs"
+    source: gmc-batch-2024-q4
+    severity: medium
+    description: Duplicate Inputs section with inconsistent casing collapsed
+
+  - fingerprint: "\\bsee also:\\s*\\[.*\\]\\(https?://internal\\..*\\)"
+    fix: ""
+    source: gmc-batch-2025-q1
+    severity: high
+    description: Internal-only URL references removed from public skill output
+    regex: true
+
+  - fingerprint: "provenance: []\n"
+    fix: "provenance:\n  - source: compilation-output\n    confidence: T1-inferred\n"
+    source: gmc-batch-2024-q4
+    severity: medium
+    description: Empty provenance array populated with minimal compilation metadata
+
+  - fingerprint: "## Steps\n\n\n\n## Outputs"
+    fix: "## Steps\n\n## Outputs"
+    source: gmc-batch-2025-q1
+    severity: low
+    description: Excessive blank lines between sections reduced to standard single blank
+
+  - fingerprint: "\\|\\s*Step\\s*\\|\\s*Status\\s*\\|\\n\\|[-\\s|]+\\|\\n(?=\\|\\s*Step)"
+    fix: ""
+    source: gmc-batch-2024-q4
+    severity: medium
+    description: Duplicated markdown table header removed from compiled output
+    regex: true

package/src/shared/references/pipeline-contracts.md

@@ -19,9 +19,10 @@ The forger also accepts common pipeline aliases:
 
 | Alias | Expands To | Description |
 |-------|-----------|-------------|
+| `deepwiki` | `AN[auto] BS[auto] CS TS[min:90] EX` | Full zero-ceremony wiki-skill pipeline |
 | `forge` | `BS CS TS EX` | Full skill creation pipeline (brief through export) |
 | `forge-quick` | `QS TS EX` | Quick skill pipeline |
-| `onboard` | `AN CS TS EX` | Full brownfield onboarding (AN generates briefs, CS consumes them directly) |
+| `onboard` | `AN CS TS EX` | Full brownfield onboarding (deprecated — use deepwiki) |
 | `maintain` | `AS US TS EX` | Maintenance cycle (audit → update → test → export) |
 
 ## Pipeline Rules
@@ -33,12 +34,17 @@ The forger also accepts common pipeline aliases:
 5. **Error halts propagate** — if any workflow hard-halts, the pipeline stops immediately
 6. **Progress reporting** — the forger reports completion of each workflow before starting the next
 
+## Pipeline Arguments
+
+Pipeline-level arguments (e.g., `--pin <version>`) are passed to the first workflow's data context. The workflow decides how to consume them. For the `deepwiki` pipeline, `--pin` flows to AN, where `step-auto-scope.md §0b` uses it for pin resolution.
+
 ## Data Flow
 
 How outputs from one workflow become inputs to the next:
 
 | From | To | Data Passed | How |
 |------|-----|------------|-----|
+| AN | BS | `brief_path` from generated brief | Forger passes the `brief_path` from AN's output to BS[auto], which loads and enriches the brief |
 | AN | CS | `skill-brief.yaml` paths from generated briefs | Forger passes each `brief_path` written by AN to CS; in batch mode, CS processes all sequentially |
 | BS | CS | `skill-brief.yaml` path | Forger passes the brief path written by BS as `brief_path` to CS |
 | CS | TS | skill name (derived from brief) | Forger passes the `skill_name` from the completed CS to TS |
@@ -57,7 +63,7 @@ Circuit breakers halt the pipeline when a workflow's output doesn't meet a quali
 |----------|-------|-------------------|----------------|
 | AN | recommended units count | min: 1 | Zero skillable units found |
 | CS | compilation success | must complete | Hard error during compilation |
-| TS | completeness score | min: 60 | Score below threshold |
+| TS | completeness score | min: 60 (per-pipeline defaults apply — see init.md §1b) | Score below 80% floor (scores between 80% and per-pipeline threshold produce a fallback PASS with evidence report — pipeline continues) |
 | AS | drift score | not CRITICAL | Critical drift found |
 | VS | feasibility verdict | not BLOCKED | All integrations blocked |
 
@@ -68,6 +74,7 @@ Override syntax: `TS[min:80]` sets the test-skill threshold to 80 for this pipel
 Brackets after a workflow code (`CODE[value]`) are parsed as follows:
 
 - **Circuit breaker override**: `min:N` where N is a number — e.g., `TS[min:80]` sets the threshold for that workflow
+- **Mode flag**: `auto` — e.g., `AN[auto]` activates auto mode for that workflow. The workflow's first step reads the flag from pipeline data context and routes to the appropriate auto-mode step file.
 - **Target argument**: any other value — e.g., `CS[cocoindex]` passes "cocoindex" as the target to CS
 
 Only workflows with a circuit breaker entry (AN, CS, TS, AS, VS) accept `min:N` overrides. All other workflows ignore `min:N` brackets. Target arguments are valid for any workflow that accepts a named input (CS, QS, BS, US, etc.).
@@ -78,12 +85,14 @@ The forger tracks pipeline state in memory during execution:
 
 ```yaml
 pipeline:
+  alias: "forge"          # pipeline alias name, or null for ad-hoc sequences
   workflows: [AN, CS, TS, EX]
   current_index: 1
   completed:
     - {code: AN, status: ok, output: {units: 3, briefs: [...]}}
   pending: [CS, TS, EX]
   data:
+    pipeline_alias: "forge" # forwarded to each workflow's data context (consumed by TS init.md §1b for per-pipeline threshold lookup)
     skill_name: "cocoindex"
     brief_path: "/path/to/skill-brief.yaml"
     target: "cocoindex"

package/src/shared/scripts/schemas/skf-brief-result-envelope.v1.json

@@ -5,7 +5,7 @@
   "description": "Single-line JSON document emitted by skf-brief-skill step 5 §4b when {headless_mode} is true, prefixed with the literal 'SKF_BRIEF_RESULT_JSON: '. Pipelines grep one line out of the workflow log to branch on the brief outcome without parsing prose. Schema mirrors the contract in src/skf-brief-skill/SKILL.md Result Contract section.",
   "type": "object",
   "additionalProperties": false,
-  "required": ["status", "brief_path", "skill_name", "version", "language", "scope_type", "exit_code", "halt_reason"],
+  "required": ["status", "brief_path", "skill_name", "version", "language", "scope_type", "exit_code", "halt_reason", "mode"],
   "properties": {
     "status": {
       "type": "string",
@@ -53,6 +53,11 @@
         "user-cancelled"
       ],
       "description": "Null on success. One of the documented HALT classes on error. Pipelines branch on this to surface the right operator message without grepping the prose error."
+    },
+    "mode": {
+      "type": ["string", "null"],
+      "enum": ["auto", null],
+      "description": "'auto' when BS was invoked with the [auto] bracket modifier (pipeline auto-brief generation). Null otherwise (interactive or headless-without-auto)."
     }
   }
 }