edercnj/x-internal-create-feature

🔒 INTERNAL SKILL — Invocada apenas por outras skills via Skill tool. Não é invocável pelo usuário diretamente. Ponto de entrada: x-refine-feature (Phase E, pós-aprovação).

Output Policy

• Efficiency: Remove fillers and avoid re-explaining repository conventions.

Skill: x-internal-create-feature

Purpose

Materialize the feature container markdown artifact (feature-<ID>.md) from an existing Feature/spec source. This internal skill preserves Source Feature, inherits RNFs from the Product / Capability / Feature chain, and derives sections 2, 4, and 8 from the Feature source — these sections are never omitted because x-refine-feature requires them for approval (dimensions: persona, alternatives, quality-strategy).

Fluxo obrigatório: Esta skill é invocada automaticamente por x-refine-feature após aprovação do refinamento da feature. Não deve ser invocada manualmente pelo usuário.

When to Use (Internal Only)

• Called by x-refine-feature Phase E when verdict == "approved"
• The Feature artifact has already been refined and approved
• Need to materialize the feature container artifact with full RNF inheritance

Prerequisites

Read before starting:

• src/templates/_TEMPLATE-FEATURE.md
• src/knowledge/shared/governance-baselines/planning-standards-ra9/knowledge.md — knowledge pack planning-standards-ra9, mandatory RA9 source of truth

If the feature source cannot be resolved, stop with a validation error.

Workflow

1. Resolve --from-feature:
   • if it is a file path, use it directly;
   • otherwise, resolve it by feature id under .aikittools/**.
2. Resolve optional --capability-file and --product-file to enrich RNF inheritance.
3. Validate feature id (4 digits, default 0001).
4. Create .aikittools/features/feature-<ID>-<slug>/feature-<ID>.md.
5. Populate all sections. For Feature-derived containers, sections ## 2, ## 4, ## 8 are derived from the Feature source — never omit them; x-refine-feature will reject the feature if any of these dimensions is absent:
   • Source Feature, Source Feature Link, ## 0.6 Inherited RNFs
   • ## 1, ## 3, ## 5, ## 6, ## 7, ## 9
   • ## 2 (Persona & Stakeholders): derive from the Feature's target user segments. x-refine-feature dimension persona requires ≥ 2 distinguishable roles — do not leave blank.
   • ## 4 (Alternativas Consideradas): derive ≥ 2 alternatives from the Feature's alternatives section with rejection rationale (Decisão de rejeição:). x-refine-feature dimension alternatives requires ≥ 2 documented alternatives.
   • ## 8 (Quality Gates): derive DoR/DoD from the Feature's acceptance criteria and quality requirements. x-refine-feature dimension quality-strategy requires at least one feature-level Done criterion (e.g., coverage target, mandatory test types).

Parameters

| Parameter | Required | Description | | :--- | :--- | :--- | | --from-feature <feature-file\|feature-id> | Yes | Feature markdown source | | --capability-file <path> | No | Capability markdown used to enrich inherited RNFs | | --product-file <path> | No | Product markdown used to extend inherited RNFs | | --feature-id <NNNN> | No | Feature identifier (default 0001) | | --output-dir <path> | No | Base output dir (default .aikittools/features) | | --dry-run | No | Validate inputs without writing files | | --no-commit | No | Skip commit (caller owns commit boundary) |

Integration Notes

• Invoked by: x-refine-feature (Phase E — post-approval feature container creation).
• Invoked by: x-create-feature (Mode B — spec-driven decomposition).
• Downstream: x-refine-feature validates the generated container's mandatory dimensions (persona, alternatives, quality-strategy).

Decision Record

Value-Driven Templates — Referência Consolidada: Define a separação entre valor e arquitetura e orienta a geração da feature no formato v2.