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

•

Productividad y Flujo de Trabajo

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

Acerca de

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.

Características Principales

Brownfield change management workflow with proposal and delta files
Standardized TDD and layered architecture documentation patterns
Greenfield feature specification templates
3-Layer context separation (Standards, Product, Spec)
Integrated Beads task tracking for dependency-aware execution
3 GitHub stars

Casos de Uso

Setting up a new repository with a production-grade organizational structure
Maintaining clear technical and product context for AI-assisted development
Proposing and tracking complex refactors or feature updates in existing codebases

Acerca de

Características Principales

Brownfield change management workflow with proposal and delta files
Standardized TDD and layered architecture documentation patterns
Greenfield feature specification templates
3-Layer context separation (Standards, Product, Spec)
Integrated Beads task tracking for dependency-aware execution
3 GitHub stars

Casos de Uso

Setting up a new repository with a production-grade organizational structure
Maintaining clear technical and product context for AI-assisted development
Proposing and tracking complex refactors or feature updates in existing codebases