What is the 3-layer directory structure?

It is a methodology that separates project context into three distinct layers: Standards (technical patterns), Product (vision and roadmap), and Spec (specific implementation requirements).

How does this skill handle changes to existing code?

It uses a brownfield workflow involving a proposal, a delta file for tracking changes, and a task list, ensuring modifications are reviewed and executed systematically.

Is this structure compatible with TDD?

Absolutely. The Layer 1 standards include patterns for Test-Driven Development (Stub → Test → Implement → Refactor) as a core coding principle.

Does this skill help with documentation?

Yes, it provides standardized templates for coding principles, architectural decisions, and product roadmaps to keep documentation in sync with the codebase.

What is Beads task tracking?

Beads is a system integrated into the structure that tracks development tasks in a git-friendly format, allowing for dependency-aware implementation (e.g., building the database layer before the API).

AgentOS Project Structure

Name: AgentOS Project Structure
Author: martinffx

bymartinffx

•

生产力与工作流

Implements a robust 3-layer directory layout for managing technical standards, product strategy, and feature specifications within Claude Code projects.

This skill organizes your development environment using the AgentOS 3-layer context model, separating technical standards, product vision, and implementation specs. It streamlines the development lifecycle by providing dedicated spaces for architectural decisions, roadmaps, and feature-specific designs. Whether starting a greenfield project or managing complex brownfield changes, this skill ensures Claude has clear, structured context to perform high-quality coding tasks while integrating seamlessly with Beads for dependency-aware task tracking.

主要功能

01Brownfield change management workflow with proposal and delta files

02Standardized TDD and layered architecture documentation patterns

03Greenfield feature specification templates

043-Layer context separation (Standards, Product, Spec)

05Integrated Beads task tracking for dependency-aware execution

063 GitHub stars

使用场景

01Setting up a new repository with a production-grade organizational structure

02Maintaining clear technical and product context for AI-assisted development

03Proposing and tracking complex refactors or feature updates in existing codebases

What are Skills?·How to Install

Install with 🐟 Skill.Fish

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

For use in Claude.ai and ChatGPT

Download Skill