cyberarian

Cyberarian - Document Lifecycle Management

This skill enforces a structured approach to documentation in Claude Code projects, ensuring consistency, discoverability, and automatic maintenance.

Core Principles

1. Structured Organization: All persistent documentation goes in docs/ with semantic categorization
2. No Temporary Docs in docs/: Ephemeral/scratch documents belong in /tmp or system temp, never in docs/
3. Metadata-Driven: YAML frontmatter enables automation and lifecycle management
4. Automatic Maintenance: Indexing and archiving happen automatically, not manually
5. Context Efficiency: Bulk operations delegate to subagents to preserve main context

Context-Efficient Operations

The Problem

Document management operations can produce verbose output that pollutes the main agent's context:

• Validation scripts listing many errors across files
• Index generation scanning dozens of documents
• Archive operations listing all files being moved
• Search results returning many matches

The Solution: Subagent Delegation

Delegate to Task subagent for operations that return verbose output. The subagent absorbs the verbose output in its isolated context and returns a concise summary (<50 tokens).

Delegation Rules

Execute directly (simple, low-output):

• Creating a single document from template
• Reading a specific document's metadata
• Checking if docs/ directory exists

Delegate to Task subagent (complex, verbose):

• Running validation across all documents
• Regenerating the index
• Archiving operations (especially dry-run)
• Searching documents by tag/status/category
• Summarizing INDEX.md contents
• Any operation touching multiple files

Delegation Pattern

When verbose output is expected:

1. Recognize the operation will be verbose
2. Delegate to Task subagent with explicit instructions
3. Subagent executes scripts, absorbs output
4. Subagent parses and returns summary <50 tokens
5. Main agent receives only essential summary