Where are technical standards stored in this structure?

Technical standards, including coding principles and architectural patterns, are stored in the docs/standards/ directory (Layer 1).

What is Beads task tracking?

Beads is a dependency-aware task management system that tracks progress in a git-friendly format, ensuring tasks are completed in the correct technical order (e.g., Entity before Repository).

How does this skill help with existing code?

It provides a 'Brownfield' workflow using proposals, deltas, and task tracking to manage changes to existing features while maintaining clear documentation of the modification process.

Does this skill require specific directory names?

Yes, it implements a specific layout (docs/standards, docs/product, docs/spec) to ensure that Claude Code can always find the relevant context it needs for a specific task.

What is the AgentOS 3-layer context model?

It is a framework that separates information into Technical Standards (Layer 1), Product Context (Layer 2), and Feature Specs (Layer 3) to give AI agents optimal context for coding tasks.

Atelier Spec Project Structure

Name: Atelier Spec Project Structure
Author: martinffx

bymartinffx

•

Productivity & Workflow

Organizes development projects using the AgentOS 3-layer context model to separate technical standards, product vision, and implementation specs.

This skill implements a rigorous directory layout designed for Agentic workflows, specifically the AgentOS 3-layer context model. It establishes a clear hierarchy by separating technical standards (Layer 1), product roadmap and vision (Layer 2), and detailed feature specifications (Layer 3). By integrating with Beads task tracking and providing structured workflows for both greenfield features and brownfield changes, it ensures that Claude Code has a consistent, predictable environment for spec-driven development, leading to higher code quality and better architectural alignment.

Key Features

016 GitHub stars

02Automated workflows for feature proposals and implementation tracking

03AgentOS 3-layer context model implementation

04Unified spec-driven development patterns for new and existing code

05Standardized directory layout for standards, product, and specs

06Integrated Beads task management with dependency awareness

Use Cases

01Managing complex feature rollouts with dependency-aware task tracking

02Organizing existing codebases to improve AI agent performance and context management

03Setting up a new project with a structured documentation and development environment

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