When should I use the Initiative Architecture skill?

Use this skill when a request is too large for a single epic, involves significant research before planning, or is expected to take weeks or months to complete.

How does this skill handle project unknowns?

It categorizes unknowns as Critical, Important, or Nice-to-Know and creates dedicated research spikes in GitHub to investigate them before implementation begins.

How does it ensure project continuity?

The skill generates a 'Context Recovery' section in the main tracking issue, allowing any developer or AI agent to resume the project by reading the decision logs and spike results.

Does it integrate with GitHub?

Yes, it uses the GitHub CLI to automate the creation of tracking issues, labels, milestones, and research spikes within your repository.

Can I use this for small feature requests?

While possible, it is optimized for 'massive' requests. For smaller, single-feature tasks, a standard epic or issue management workflow is usually more efficient.

Initiative Architecture & Planning

Name: Initiative Architecture & Planning
Author: troykelly

bytroykelly

0•

Collaboration Tools

Structures massive software projects into manageable epics and milestones through research-driven architecture and decision logging.

The Initiative Architecture skill is designed for high-level software planning when a work request is too complex for a single epic. It provides a systematic framework for decomposing massive projects by identifying critical unknowns, executing time-boxed research spikes, and maintaining a transparent decision log. By transforming vague requirements into structured GitHub epics and delivery milestones, it ensures that long-term development remains trackable, organized, and resumable across different AI sessions.

Key Features

01Multi-phase project decomposition from investigation to implementation

020 GitHub stars

03Systematic identification and prioritization of project unknowns

04Automated creation of GitHub research spikes and initiative tracking issues

05Structured decision logging with context, options, and trade-off analysis

06Seamless mapping of architecture into GitHub epics, labels, and milestones

Use Cases

01Architecting complex infrastructure migrations with significant technical unknowns

02Decomposing high-level product visions into concrete, actionable development roadmaps

03Planning a new platform feature that spans multiple weeks or months of development

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add troykelly/claude-skills initiative-architecture

For use in Claude.ai and ChatGPT

Download Skill