Skip to content

feat: add /align --content sub-flag + content-allocation skill + templates #1123

@akaszubski

Description

@akaszubski

Summary

Add /align --content sub-flag to the existing /align command — runs the content allocation workflow (audit → propose → execute) interactively. Ship the methodology as a skill and the rulebook as templates so other repos get the pattern via /sync.

Implementation Approach

  1. Extend plugins/autonomous-dev/commands/align.md:
    • Add --content mode section parallel to existing --docs, --project, --retrofit
    • Workflow: audit (CLAUDE.md / PROJECT.md / MEMORY.md sizes, duplication scan) → propose (deletes / moves / rewrites by repo type) → interactive approval → execute
    • Update "Quick Usage", "Mode Detection", "When to Use Each Mode" tables
  2. New skill plugins/autonomous-dev/skills/content-allocation/SKILL.md:
    • Methodology + routing rules (mirror realign's docs/development/CONTENT_ALLOCATION.md)
    • Adaptation table by repo type (code / operational / knowledge)
    • Triggers: "where does X go", "duplicate content", "cleanup memory"
  3. Promote Issue Implement progressive commit workflow (4 levels) #1's CONTENT_ALLOCATION.md as plugins/autonomous-dev/templates/CONTENT_ALLOCATION.md (canonical template that gets dropped into installed repos).
  4. New template plugins/autonomous-dev/templates/CLAUDE.md.template (currently only PROJECT.md.template exists; CLAUDE.md template is genuinely missing).
  5. Update plugin .claude/CLAUDE.md template with a 3-line section pointing to /align --content and docs/development/CONTENT_ALLOCATION.md. Auto-propagates to installed repos via /sync.
  6. Update install path to drop new templates only when missing (never overwrite).

Acceptance Criteria

  • /align --content documented in commands/align.md following existing pattern
  • /align --content runs end-to-end interactively (audit → propose → approve → execute)
  • Skill exists at correct path; loads when triggered
  • Both new templates exist in plugins/autonomous-dev/templates/
  • Plugin .claude/CLAUDE.md template includes content allocation pointer
  • Install drops templates only when missing (never overwrite user content)
  • Tests cover: (a) command routing for --content, (b) skill load, (c) template-drop idempotency
  • Existing /align, /align --docs, /align --project, /align --retrofit unchanged

Notes

Part of Stream B of .claude/plans/content-allocation-retrofit.md. Architecture decision (sub-flag vs new Phase): chose --content sub-flag to parallel --docs/--project/--retrofit and enable standalone hygiene without forcing full retrofit. Pairs with Issue #2 (extended hook). Both block #4 (live validation).

Plugin Version: 3.50.0 (845f0f8)

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions