workflows-plan

The workflows-plan skill is a professional engineering assistant designed to bridge the gap between abstract requirements and concrete development execution. It is intended for software engineers, project managers, and technical leads who need to maintain architectural consistency and project velocity. By analyzing existing codebase patterns, team conventions found in AGENTS.md, and relevant framework documentation, this skill creates comprehensive implementation plans that minimize ambiguity and development risk.

• Automatically spawns parallel research agents to gather context on codebase conventions, industry best practices, and framework-specific requirements.

• Provides tiered planning templates ranging from MINIMAL for quick patches to A LOT for major architectural overhauls and long-term feature development.

• Integrates stakeholder analysis and identifies dependencies, risks, and success metrics to ensure project alignment before a single line of code is written.

• Incorporates SpecFlow analysis to validate specifications, identify edge cases, and refine acceptance criteria based on collected research.

• Supports standard git-style categorization, including feat, fix, and refactor, to keep issues searchable and organized.

• Users should provide clear feature descriptions or bug reports as input; the skill will prompt for additional details if requirements are insufficient.

• The output is generated in standard markdown, making it immediately compatible with PR templates, issue tracking systems, or further processing via workflows-work.

• Research findings are tracked with specific file paths and line numbers, enabling developers to quickly jump to the relevant context during implementation.

• Recommended for use with the broader compound-engineering-amp suite, leveraging specialized guidance files and multi-agent orchestration for high-quality software delivery.

• Ensures compliance with project conventions by referencing internal team documentation during the initial research phase.