Does this skill work with any repository structure?

It is optimized for the Principled framework's structure, which includes specific directories like docs/proposals/, docs/plans/, and docs/decisions/.

How does it use Domain-Driven Development (DDD)?

It applies DDD concepts during implementation planning, helping decompose tasks into bounded contexts, aggregates, and domain events for more modular code.

Is this skill manually invoked by the user?

No, it is a background skill that informs Claude's behavior automatically whenever it encounters documentation-related context or files like CLAUDE.md and INTERFACE.md.

How does this skill handle ADRs?

It treats Architecture Decision Records (ADRs) as immutable once accepted. This ensures a reliable audit trail, using a 'superseded_by' mechanism if a decision is later changed.

What is the Proposals to Decisions pipeline?

It is a structured workflow where project ideas are drafted as proposals, reviewed for architectural impact, and then finalized as immutable decisions or actionable implementation plans.

Principled Documentation Strategy

Name: Principled Documentation Strategy
Author: alexnodeland

byalexnodeland

•

학습 및 문서화

Enforces a specification-driven documentation pipeline for the Principled framework using automated lifecycle rules and domain-driven design.

This skill equips Claude Code with the specialized knowledge required to manage the complex documentation ecosystem of the Principled framework. It facilitates the transformation of ideas into implementations through a rigorous proposals-decisions-plans pipeline, ensuring structural consistency and architectural integrity. By applying naming conventions, lifecycle transitions for proposals, and immutable Architecture Decision Records (ADRs), the skill ensures that project documentation remains organized, auditable, and aligned with domain-driven design principles. It is essential for scaffolding new modules and maintaining long-term architectural clarity in specification-driven development.

주요 기능

01Standardized scaffolding for core, library, and application modules

02Automated lifecycle management for proposals and implementation plans

03Management of immutable Architecture Decision Records (ADRs)

04Enforcement of NNN-short-title naming conventions and slug rules

05Domain-driven decomposition for structured implementation planning

063 GitHub stars

사용 사례

01Managing the state transition of a proposal from draft to accepted or superseded

02Validating project documentation against the Principled framework structural specification

03Scaffolding a new software module with mandatory architectural and documentation files

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add alexnodeland/principled docs-strategy

For use in Claude.ai and ChatGPT

Download Skill