Why
AI IDEs generate requirements, architecture, and code but have no structured intent-capture workflow. The result is "green specs, wrong product" — every contract passes but the shipped feature misses the business outcome because no tool validated the upstream intent. ai-integration-01-agent-skill ships general spec-validation skills; it does not provide the upstream intent-engineering workflow (structured business intent interview, requirements decomposition, architecture derivation, trace validation). A dedicated intent skills set — following the SQUER intent interview model and the open Agent Skills standard — closes this gap by making persona-outcome capture and traceability validation available as first-class IDE slash commands across all supported AI IDE platforms.
What Changes
- NEW: Intent-engineering Agent Skills at
skills/specfact-intent/:
skills/specfact-intent/SKILL.md — umbrella intent skills entrypoint (~80 tokens at rest)skills/specfact-intent-capture/SKILL.md — SQUER 7-question intent interview; captures to .specfact/requirements/{id}.req.yamlskills/specfact-intent-decompose/SKILL.md — Decomposes BusinessOutcome into BusinessRule (G/W/T) and ArchitecturalConstraintskills/specfact-intent-architecture/SKILL.md — Generates ADRs from requirements via specfact architecture deriveskills/specfact-intent-trace-validate/SKILL.md — Validates full traceability chain and generates structured fix prompts for gapsskills/specfact-intent-evidence-check/SKILL.md — Checks evidence completeness across the intent-to-code chain
- NEW:
specfact ide skill install --type intent — installs intent skills to the IDE-appropriate location
- EXTEND:
specfact ide skill install — adds --type {spec,intent,all} option (backwards-compatible default: spec)
- EXTEND:
specfact ide skill list — enumerates both spec and intent skill types with install status
Acceptance Criteria
- All 6 intent skill files are present and have valid YAML frontmatter
specfact ide skill install --type intent installs all 6 files successfullyspecfact ide skill install (no --type) behaves identically to pre-change behaviourspecfact ide skill list shows both spec and intent skill types- SQUER 7-question interview maps correctly to
BusinessOutcome fields
- Each skill verifies CLI prerequisites before activation
- Unit and contract tests pass; docs updated
Dependencies
OpenSpec Change Proposal: ai-integration-04-intent-skills
Why
AI IDEs generate requirements, architecture, and code but have no structured intent-capture workflow. The result is "green specs, wrong product" — every contract passes but the shipped feature misses the business outcome because no tool validated the upstream intent.
ai-integration-01-agent-skillships general spec-validation skills; it does not provide the upstream intent-engineering workflow (structured business intent interview, requirements decomposition, architecture derivation, trace validation). A dedicated intent skills set — following the SQUER intent interview model and the open Agent Skills standard — closes this gap by making persona-outcome capture and traceability validation available as first-class IDE slash commands across all supported AI IDE platforms.What Changes
skills/specfact-intent/:skills/specfact-intent/SKILL.md— umbrella intent skills entrypoint (~80 tokens at rest)skills/specfact-intent-capture/SKILL.md— SQUER 7-question intent interview; captures to.specfact/requirements/{id}.req.yamlskills/specfact-intent-decompose/SKILL.md— DecomposesBusinessOutcomeintoBusinessRule(G/W/T) andArchitecturalConstraintskills/specfact-intent-architecture/SKILL.md— Generates ADRs from requirements viaspecfact architecture deriveskills/specfact-intent-trace-validate/SKILL.md— Validates full traceability chain and generates structured fix prompts for gapsskills/specfact-intent-evidence-check/SKILL.md— Checks evidence completeness across the intent-to-code chainspecfact ide skill install --type intent— installs intent skills to the IDE-appropriate locationspecfact ide skill install— adds--type {spec,intent,all}option (backwards-compatible default:spec)specfact ide skill list— enumerates both spec and intent skill types with install statusAcceptance Criteria
specfact ide skill install --type intentinstalls all 6 files successfullyspecfact ide skill install(no--type) behaves identically to pre-change behaviourspecfact ide skill listshows bothspecandintentskill typesBusinessOutcomefieldsDependencies
ai-integration-01-agent-skill(Agent Skill for Spec Intelligence (Skills-First Interface) #251) — skill install infrastructure must existrequirements-01-data-model(Requirements Data Model & Storage #238) — intent skills invokespecfact requirements capturerequirements-02-module-commands(Requirements Module — Extract, Author, Validate Commands #239) — skills callspecfact requirements validateandspecfact requirements traceOpenSpec Change Proposal: ai-integration-04-intent-skills