afc:principles

/afc:principles — Manage Project Principles

Creates and manages the project's core principles (constitution). Stored in .claude/afc/memory/principles.md and referenced across all sessions.

Arguments

• $ARGUMENTS — (optional) action directive:
  • not specified: view current principles
  • add {principle}: add a new principle
  • remove {number}: remove a principle
  • init: interactive initial setup

Project Config (auto-loaded)

!cat .claude/afc.config.md 2>/dev/null || echo "[CONFIG NOT FOUND] .claude/afc.config.md not found. Create it with /afc:init."

Execution Steps

1. Check Current State

Read .claude/afc/memory/principles.md:

• If present: load existing principles
• If absent: empty state (show init instructions)

2. Action Branch

A. View (no arguments)

Display current principles list:

Project Principles
├─ MUST-001: {principle}
├─ MUST-002: {principle}
├─ SHOULD-001: {principle}
└─ Last updated: {date}

B. Initial Setup (init)

Collect principles interactively:

1. Analyze project context (CLAUDE.md, package.json, code structure)
2. Suggest automatically extractable principles:
   • Comply with {config.architecture} rules
   • Follow {config.code_style}
   • Zero lint warnings (per {config.ci})
   • etc.
3. Ask user for additional principles (AskUserQuestion)
4. Structure collected principles

C. Add (add)

1. Determine strength of the new principle (MUST / SHOULD / MAY)
2. Add to principles.md
3. Update version

D. Remove (remove)

1. Confirm the principle
2. Remove after user confirmation
3. Update version (MAJOR)

3. Storage Format

# Project Principles

> Version: {MAJOR.MINOR.PATCH}
> Last Updated: {YYYY-MM-DD}

## MUST (non-negotiable)
- **MUST-001**: {principle} — {rationale}
- **MUST-002**: {principle} — {rationale}

## SHOULD (strongly recommended)
- **SHOULD-001**: {principle} — {rationale}

## MAY (optional)
- **MAY-001**: {principle} — {rationale}

## Changelog
- {date}: {change description}