317 Roadmap 225f2695

Claude Skills Roadmap

Current Status

Version: v0.4.8 (Released January 2026)

• 66 Skills across 12 domains
• 365 Reference Files with progressive disclosure architecture
• 30+ Frameworks and technologies covered
• 9 Project Workflow Commands for epic planning, discovery, execution, and retrospectives
• 50% Token Reduction through selective disclosure architecture
• Skills organized by domain: Backend, Frontend, DevOps, Mobile, Data, Security, Product, and Business

Development Timeline

v0.4.2 ──────> v0.5.0 ──────> v0.6.0 ──────> v0.7.0 ──────> v1.0.0
(Current)      Workflow       Local-First    Skill          Stable
               Overhaul       Config         Routing        Release

v0.3.0 - Domain Expansion & Stabilization (Released)

Released: December 26, 2025 | Patches: v0.3.1 (2025-12-26), v0.3.2 (2026-01-17)

Added 9 skills across Data Science (pandas-pro, spark-engineer, ml-pipeline), AI/LLM (prompt-engineer, rag-architect, fine-tuning-expert), and Platform (salesforce-developer, shopify-expert, wordpress-pro) domains. Completed skill trigger validation, routing table accuracy audit, and reference documentation for test-master, debugging-wizard, and code-reviewer enhancements.

v0.4.0 - Project Workflow Commands & Cross-Referencing (Released)

Released: January 18, 2026 | Patches: v0.4.1 (2026-01-19), v0.4.2 (2026-01-29)

Introduced 9 project workflow commands spanning discovery, planning, execution, and retrospective phases. Added Atlassian MCP integration for Jira/Confluence operations, epic-driven development lifecycle, and Common Ground assumption-surfacing skill. Established the progressive disclosure architecture with tiered reference loading.

v0.5.0 - Workflow Overhaul

Scope: Decouple workflow commands from Jira/Confluence, add per-project backend configuration, create a project intake phase, rework discovery for product-centric workflows, integrate feature-forge into the pipeline.

See docs/v0.5.0-plan.md for the consolidated implementation plan.

Backend Adapter Pattern

• #62: Generalize workflow commands for multiple ticketing and documentation systems
• #119: Backend adapter reference files (9 reference files for local, Jira, GitHub Issues, Confluence, GitHub Wiki backends)
• Per-project config via .claude/workflow-config.json — ticketing (local | jira | github-issues) and documentation (local | confluence | github-wiki)

Intake Commands (New Phase)

• #120: Three new commands — intake:document-codebase, intake:capture-behavior, intake:create-system-description
• Generates living system documentation, characterization tests, and SOC2-style system description

Discovery Rework

• #121: Full rewrite — topic-based input (not Jira epic key), local-first sources, produces epics AND tickets
• #103: Epic creation gap fix — discovery now creates epics, not just tickets

Feature-Forge Integration

• #122: System description context (Step 0), discovery recommendation ("Needs additional discovery" standing option), output boundaries (optional EARS), skill-aware ticket generation

Namespace & Directory Restructure

• #123: Drop project: prefix — project:phase:action becomes phase:action; flatten commands/project/ to commands/; remove complete-sprint command

Already Completed (Phase 1-2)

• #124: YAML workflow definition schema + DAG manifest
• #125: Narrative document restructure with per-command metadata

Infrastructure

• #126: CI portability check — GitHub Action asserting npx skills detection matches version.json

Command Count: 11

• 3 new (intake), 7 reworked (backend-agnostic), 1 removed (complete-sprint)

v0.6.0 - Local-First Configuration

Scope: Global-to-local config migration, per-project skill activation, workflow infrastructure hardening.

This release moves configuration from global to per-project, enabling teams to customize skill sets and workflow behavior per repository. Builds on the backend adapter pattern from v0.5.0.

Configuration Migration

• Discussion #112: Global-to-local config migration — .claude/skills/ local install strategy, meta-skill/project analyzer
• Per-project skill activation — select which skills are active for a given repository

Workflow Infrastructure

• #50: Context Persistence — auto-store epic workflow state
• #51: State Validation — prevent commands from running out of order
• #52: Error Recovery — resume/rollback/retry mechanisms
• #53: Extract Shared Templates — centralize checkpoint patterns
• #54: Regression Test Suite — automated execution testing
• #55: Performance & Security Testing — systematic integration

Common Ground

• #109: Common-ground local storage — persist assumptions per project

v0.7.0 - Enhanced Skill Routing

Scope: Improved skill discovery and routing, common-ground workflow integration. Depends on v0.6.0 local config.

Skill Routing Improvements

• #65: Cross-Domain Recommendations — suggest complementary skills from different domains
• #66: Enhanced Routing Logic — context-aware skill selection
• #68: Skill Dependency Mapping — represent skill relationships
• #69: Skill metadata enhancement — structured metadata field for richer skill descriptors

Common Ground Enhancements

• #108: Common-ground SessionStart hook — automatic assumption surfacing on session start
• #110: Common-ground progressive disclosure — phased assumption surfacing
• #111: Common-ground UserPromptSubmit hook — contextual assumption checks

Feasibility Evaluation

• #64: Smart Skill Discovery — consolidates #70, #71, #72; requires third-party tooling evaluation (vector embeddings, semantic search). Tracked separately pending feasibility assessment.

v1.0.0 - Stable Release

Scope: Production-ready platform with comprehensive testing and documentation.

Production Readiness

• Comprehensive test coverage
• Performance benchmarks established
• Security audit completed
• Documentation complete for all commands, skills, and configuration
• Migration guides for all versions

Stable Guarantees

• Semantic versioning commitment
• Backward compatibility within major version
• Long-term support model

Beyond v1.0.0 - Future Considerations

• Marketplace for community-created skills
• Plugin architecture for custom integrations
• Team collaboration features
• IDE integrations
• CI/CD pipeline connectors

Contributing to the Roadmap

We welcome community input on the roadmap direction. Here's how you can contribute:

Suggest Features

• Open a GitHub issue with the enhancement label
• Use the feature request template
• Explain the use case and expected benefits

Vote on Priorities

• React to existing feature requests
• Comment with your use cases
• Help refine feature specifications

Contribute Skills

• Follow the skill creation guide
• Submit pull requests for new skills
• Improve existing skill documentation

Share Feedback

• Report bugs and issues promptly
• Suggest improvements to existing skills
• Participate in community discussions

Versioning Philosophy

Semantic Versioning: We follow semver (MAJOR.MINOR.PATCH)

• MAJOR: Breaking changes, major architecture shifts
• MINOR: New features, new skills, backward-compatible additions
• PATCH: Bug fixes, documentation updates, minor improvements

Release Cadence:

• Minor versions: Quarterly
• Patch versions: As needed
• Major versions: When significant architecture changes occur

Backward Compatibility:

• Skills maintain compatibility within major versions
• Deprecation notices provided one minor version in advance
• Migration guides for breaking changes
• Support for previous minor version maintained

Stay Updated

• GitHub: Watch the repository for updates
• Releases: Follow the releases page for version announcements
• Discussions: Participate in roadmap discussions
• Issues: Track progress on specific features

This roadmap is a living document and subject to change based on community feedback, technical constraints, and emerging priorities. Last updated: February 2026 (v0.4.8)