workflow-strategy

Generates solution-strategy documents with key ideas, research, and ADRs for Phase 5.

Updated Mar 14, 2026
One-click install
npx skills add https://github.com/jcg-admin/IACT-ui --skill workflow-strategy-jcg-admin
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: workflow-strategy
Source: https://github.com/jcg-admin/IACT-ui/tree/main/.claude/skills/workflow-strategy
Command: npx skills add https://github.com/jcg-admin/IACT-ui --skill workflow-strategy-jcg-admin

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) and assets (resource) components.

What problem does it solve? It prevents architecture decisions made without evidence by guiding Phase 5 STRATEGY of a work package: investigating alternatives, documenting trade-offs, and producing a solution-strategy.md before implementation begins. ## Core Features & Use Cases - Structured Strategy Document: Creates a {wp}-solution-strategy.md from a template with Key Ideas, Research, Fundamental Decisions, Technology Stack, Patterns, and Quality Goals sections. - ADR Generation: Produces Architecture Decision Records in context/decisions/ for significant architectural choices, with pre-design and post-design consistency checks against constraints and constitution. - Gate & Size Re-evaluation: Enforces a human approval gate before Phase 6 and re-evaluates work package size (micro to large) to adjust which phases run next. - Use Case: After completing discovery and constraints analysis for a new feature, invoke this skill to research alternatives (e.g., REST vs GraphQL), document the decision with justification, and get explicit approval before planning. ## Quick Start Ask the assistant to start Phase 5 STRATEGY for the active work package and produce the solution-strategy document with key ideas and ADRs.

Frequently Asked Questions about workflow-strategy

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I document architecture decisions before implementation?▼

Run Phase 5 STRATEGY to create a solution-strategy.md capturing key ideas, researched alternatives with pros and cons, and fundamental decisions with justification. Significant decisions are also recorded as ADRs in context/decisions/.

What is an ADR and when should I create one?▼

An ADR (Architecture Decision Record) documents a significant architectural choice, its alternatives, and its rationale. Create one during the strategy phase whenever a decision has long-term structural impact, using the provided adr.md.template.

What sections must a solution strategy document contain?▼

The document requires five mandatory sections: Key Ideas, Research, Fundamental Decisions, Technology Stack and Patterns, and Quality Goals strategies. The template also adds constraint adherence, traceability, and an evidence classification table.

Can I skip the strategy phase for small work packages?▼

The skill re-evaluates work package size after strategy; micro and small packages proceed directly to execution, while medium or large ones continue through planning phases. The size assessment from Phase 1 determines which phases are active.

Why does the workflow stop before Phase 6 planning?▼

A human gate requires explicit approval of the key ideas, decisions, and discarded alternatives before continuing. This prevents unreviewed architectural commitments from propagating into planning and execution.