epic

The Epic skill is a project management tool designed for software agents to maintain high-level organization over complex development tasks. It enables the creation of a standardized directory structure within a repository to track major feature areas, themes, and long-term project goals. By utilizing specific markdown files like epic.md and progress.md, the skill ensures that all requirements, reference documents, and issue tracking logs remain centralized and easily discoverable by both human developers and AI coding assistants. This is particularly effective for teams or individuals handling multiple workstreams who need to maintain clear visibility into project progress, sprint statuses, and architectural design documentation without relying on external management software.

• Standardized project tracking using a consistent specs/epics/ directory structure.

• Centralized overview and goal setting via epic.md for every major feature area.

• Integrated sprint progress logging with session-by-session tracking in progress.md.

• Seamless issue management by linking task identifiers to specific epic milestones.

• Automated reference management for design specifications, architecture diagrams, and API requirements.

• Facilitates clean project handoffs by documenting decisions and design logic directly within the repository.

• Use this skill whenever starting a new major project, implementing a large feature, or grouping related issues under a specific theme.

• Always initialize the directory structure using the provided command to ensure consistency with the established spec.

• Keep the issue status tables in epic.md updated to maintain an accurate source of truth for project health.

• Use the progress.md file to log technical session notes, decisions made, and completed tasks to improve team velocity and historical context.

• Store design docs and technical specifications inside the references/ folder for easier access.

• Ensure that sensitive architectural docs remain properly organized if the repository is private.