Create Stack Skill
Overview
Produces a consolidated stack skill documenting how libraries connect. Code-mode analyzes dependency manifests and co-import patterns from actual source code. Compose-mode synthesizes from pre-generated individual skills and architecture documents when no codebase exists yet. Every finding must trace to actual code with file:line citations; in compose-mode, inferred integrations are permitted but must be labeled [inferred from shared domain].
Role
You are a dependency analyst and integration architect operating in Ferris Architect mode. You bring expertise in dependency analysis, cross-library integration patterns, and compositional architecture, while the user brings their project knowledge and scope preferences.
Workflow Rules
These rules apply to every step in this workflow:
- Zero hallucination — all extracted content must trace to actual source code (compose-mode inferences must be labeled)
- Read each step file completely before taking any action
- Follow the mandatory sequence in each step exactly — do not skip, reorder, or optimize
- Only load one step file at a time — never preload future steps
- If any instruction references a subprocess or tool you lack, achieve the outcome in your main context thread
- Always communicate in
{communication_language}
- If
{headless_mode} is true, auto-proceed through confirmation gates with their default action and log each auto-decision
- Workflow state contract —
workflow_warnings[] accumulator (M4): every step that emits a warning ("log a warning", "record in workflow state for the evidence report", "Warning: ...", etc.) MUST append a structured entry to a single in-memory list named workflow_warnings[]. Each entry has the shape {step: "step-NN", severity: "info|warn|error", code: "<short-slug>", message: "<human text>", context: {<optional fields>}}. Step-07 surfaces these in evidence-report.md; step-08 may add validation findings; step-09 §5 reads the accumulated list and renders the user-facing "Warnings" section. Do not invent a per-step warning channel — there is exactly one accumulator for the whole workflow.
Stages
| # |
Step |
File |
Auto-proceed |
| 1 |
Initialize & Mode Detection |
steps-c/step-01-init.md |
No (confirm) |
| 2 |
Detect Manifests |
steps-c/step-02-detect-manifests.md |
Yes |
| 3 |
Rank & Confirm Libraries |
steps-c/step-03-rank-and-confirm.md |
No (confirm) |
| 4 |
Parallel Extract |
steps-c/step-04-parallel-extract.md |
Yes |
| 5 |
Detect Integrations |
steps-c/step-05-detect-integrations.md |
Yes |
| 6 |
Compile Stack |
steps-c/step-06-compile-stack.md |
No (review) |
| 7 |
Generate Output |
steps-c/step-07-generate-output.md |
Yes |
| 8 |
Validate |
steps-c/step-08-validate.md |
Yes |
| 9 |
Report |
steps-c/step-09-report.md |
Yes |
| 10 |
Workflow Health Check |
steps-c/step-10-health-check.md |
Yes |
Invocation Contract
| Aspect |
Detail |
| Inputs |
project_path [required], mode (code/compose) [auto-detected] |
| Gates |
step-03: Confirm Gate [C] |
| Outputs |
SKILL.md (stack), context-snippet.md, metadata.json |
| Headless |
All gates auto-resolve with default action when {headless_mode} is true |
On Activation
Load config from {project-root}/_bmad/skf/config.yaml and resolve:
project_name, output_folder, user_name, communication_language, document_output_language, skills_output_folder, forge_data_folder, sidecar_path
Resolve {headless_mode} with explicit precedence (B2):
- Explicit disable wins. If
--headless=false or --no-headless was passed, {headless_mode} is false regardless of any preference.
- Explicit enable next. If
--headless or -H was passed (without =false), {headless_mode} is true.
- Preferences fallback. Otherwise, read
headless_mode from {sidecar_path}/preferences.yaml (true or false).
- Default:
false.
Load, read the full file, and then execute ./steps-c/step-01-init.md to begin the workflow.
1---2name: skf-create-stack-skill3description: Consolidated project stack skill with integration patterns — code-mode (analyzes manifests) or compose-mode (synthesizes from existing skills + architecture doc). Use when the user requests to "create a stack skill."4---56# Create Stack Skill78## Overview910Produces a consolidated stack skill documenting how libraries connect. **Code-mode** analyzes dependency manifests and co-import patterns from actual source code. **Compose-mode** synthesizes from pre-generated individual skills and architecture documents when no codebase exists yet. Every finding must trace to actual code with file:line citations; in compose-mode, inferred integrations are permitted but must be labeled `[inferred from shared domain]`.1112## Role1314You are a dependency analyst and integration architect operating in Ferris Architect mode. You bring expertise in dependency analysis, cross-library integration patterns, and compositional architecture, while the user brings their project knowledge and scope preferences.1516## Workflow Rules1718These rules apply to every step in this workflow:1920- Zero hallucination — all extracted content must trace to actual source code (compose-mode inferences must be labeled)21- Read each step file completely before taking any action22- Follow the mandatory sequence in each step exactly — do not skip, reorder, or optimize23- Only load one step file at a time — never preload future steps24- If any instruction references a subprocess or tool you lack, achieve the outcome in your main context thread25- Always communicate in `{communication_language}`26- If `{headless_mode}` is true, auto-proceed through confirmation gates with their default action and log each auto-decision27- **Workflow state contract — `workflow_warnings[]` accumulator (M4):** every step that emits a warning ("log a warning", "record in workflow state for the evidence report", "Warning: ...", etc.) MUST append a structured entry to a single in-memory list named `workflow_warnings[]`. Each entry has the shape `{step: "step-NN", severity: "info|warn|error", code: "<short-slug>", message: "<human text>", context: {<optional fields>}}`. Step-07 surfaces these in `evidence-report.md`; step-08 may add validation findings; step-09 §5 reads the accumulated list and renders the user-facing "Warnings" section. Do not invent a per-step warning channel — there is exactly one accumulator for the whole workflow.2829## Stages3031| # | Step | File | Auto-proceed |32|---|------|------|--------------|33| 1 | Initialize & Mode Detection | steps-c/step-01-init.md | No (confirm) |34| 2 | Detect Manifests | steps-c/step-02-detect-manifests.md | Yes |35| 3 | Rank & Confirm Libraries | steps-c/step-03-rank-and-confirm.md | No (confirm) |36| 4 | Parallel Extract | steps-c/step-04-parallel-extract.md | Yes |37| 5 | Detect Integrations | steps-c/step-05-detect-integrations.md | Yes |38| 6 | Compile Stack | steps-c/step-06-compile-stack.md | No (review) |39| 7 | Generate Output | steps-c/step-07-generate-output.md | Yes |40| 8 | Validate | steps-c/step-08-validate.md | Yes |41| 9 | Report | steps-c/step-09-report.md | Yes |42| 10 | Workflow Health Check | steps-c/step-10-health-check.md | Yes |4344## Invocation Contract4546| Aspect | Detail |47|--------|--------|48| **Inputs** | project_path [required], mode (code/compose) [auto-detected] |49| **Gates** | step-03: Confirm Gate [C] | step-06: Review Gate [C] |50| **Outputs** | SKILL.md (stack), context-snippet.md, metadata.json |51| **Headless** | All gates auto-resolve with default action when `{headless_mode}` is true |5253## On Activation54551. Load config from `{project-root}/_bmad/skf/config.yaml` and resolve:56 - `project_name`, `output_folder`, `user_name`, `communication_language`, `document_output_language`, `skills_output_folder`, `forge_data_folder`, `sidecar_path`57582. **Resolve `{headless_mode}`** with explicit precedence (B2):59 1. **Explicit disable wins.** If `--headless=false` or `--no-headless` was passed, `{headless_mode}` is `false` regardless of any preference.60 2. **Explicit enable next.** If `--headless` or `-H` was passed (without `=false`), `{headless_mode}` is `true`.61 3. **Preferences fallback.** Otherwise, read `headless_mode` from `{sidecar_path}/preferences.yaml` (`true` or `false`).62 4. **Default:** `false`.63643. Load, read the full file, and then execute `./steps-c/step-01-init.md` to begin the workflow.
armelhbobdad