How does the Beads system handle task dependencies?

Beads surfaces the next unblocked task based on technical order (e.g., Entity → Repository → Service), ensuring a logical and stable bottom-up implementation flow.

What is the 3-layer context model in AgentOS?

It categorizes project knowledge into Standards, Product, and Specs layers. This allows Claude to load only the specific context needed for the current task, preventing information overload.

How does orchestrated delegation work with this skill?

The methodology uses specialized subagents like the Architect for design, the Oracle for analysis, and the Clerk for retrieval, ensuring each part of the dev cycle uses the best-suited model.

What makes OpenSpec 'living' specifications?

OpenSpec documents are updated throughout the development lifecycle. They serve as a constant source of truth that evolves as requirements change, ensuring humans and AI remain aligned.

Atelier Spec-Driven Methodology

Name: Atelier Spec-Driven Methodology
Author: martinffx

bymartinffx

•

Productivity & Workflow

Implements a structured, spec-driven development framework using tiered context layers and orchestrated subagents for high-precision code generation.

This skill enhances Claude Code with the AgentOS 3-layer context model and the OpenSpec methodology, ensuring that the AI maintains a clear understanding of standards, product goals, and technical requirements. By utilizing specialized subagents—Clerk, Oracle, and Architect—it breaks down complex features into manageable, dependency-tracked tasks using the Beads system. This approach prevents context window saturation and ensures that human-AI alignment is established through living specifications before any implementation begins, making it ideal for professional-grade software architecture and brownfield development.

Key Features

016 GitHub stars

023-Layer Context Model (Standards, Product, Specs) to optimize token usage and focus.

03Orchestrated delegation to specialized subagents including Clerk, Oracle, and Architect.

04Living specifications (OpenSpec) with SHALL/MUST requirements and hierarchical scenarios.

05Dependency tracking via Beads for enforced bottom-up technical implementation order.

06Delta-based change management for tracking ADDED, MODIFIED, and REMOVED requirements.

Use Cases

01Establishing a rigorous single source of truth between human stakeholders and AI agents using living specs.

02Orchestrating multi-step development tasks that require architectural oversight and strict task dependency management.

03Managing complex feature additions in large, existing codebases using structured deltas and context layering.

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add martinffx/claude-code-atelier atelier-spec-methodology

For use in Claude.ai and ChatGPT

Download Skill