Does this skill handle updates to existing code?

Yes, it includes a specific workflow for 'brownfield' changes using proposal and delta files to track and merge modifications to existing codebases safely.

How does this improve AI-driven development?

By providing a predictable location for all documentation, Claude can find relevant technical patterns and business rules faster, leading to higher-quality code that follows your specific project standards.

What is the AgentOS 3-layer context model?

It is a directory organization strategy that separates technical standards (Layer 1), product roadmap (Layer 2), and feature specifications (Layer 3) to give AI agents clearer, prioritized context.

What is the .beads directory used for?

The .beads directory stores task data and dependency information, allowing Claude to execute implementation steps in a logical, technical order like Entity → Repository → Service.

Spec-Driven Project Structure

Name: Spec-Driven Project Structure
Author: martinffx

bymartinffx

•

Productivity & Workflow

Implements a structured 3-layer directory layout to manage technical standards, product vision, and feature specifications for AI-driven development.

This skill establishes a standardized AgentOS 3-layer context model within your repository, ensuring Claude has structured access to technical standards, product roadmaps, and feature specifications. By organizing documentation into 'Standards' (how to build), 'Product' (what and why), and 'Specs' (what to build next), it optimizes AI context management and maintains architectural consistency across the project. It integrates seamlessly with the Beads task tracking system to manage technical dependencies and execution workflows for both greenfield features and brownfield code modifications.

Key Features

016 GitHub stars

02Standardized documentation for coding principles and architecture decisions

03AgentOS 3-Layer Context Model implementation

04Automated spec-driven development workflows for new features

05Integrated Beads task management for dependency-aware implementation

06Structured brownfield change management with proposal and delta tracking

Use Cases

01Managing complex feature updates through a structured workflow of proposals, deltas, and task execution.

02Bootstrapping a new project with an AI-ready directory structure that prioritizes context clarity.

03Organizing existing project documentation to improve Claude's reasoning about technical and business goals.

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add martinffx/claude-code-atelier atelier-spec-project-structure

For use in Claude.ai and ChatGPT

Download Skill