Feature: Tag-Based Guidance Parsing

[stevei101]

Tag-Based Guidance Parser

Parse AGENTS.md files with role-specific tags for rule extraction.

Tag System

• <@all> - Rules for all agents
• <@architect> - Architect-specific rules
• <@builder> - Builder-specific rules
• <@auditor> - Auditor-specific rules
• <@human> - Human-specific rules
• Custom tags via config

Parser Features

• Extract rules from tagged sections
• Handle nested/complex markdown
• Validate tag structure
• Generate role-specific documents
• Support markdown formatting preservation

Example

# Governance Rules

<@all>
All agents must:
- Follow these core principles
- Maintain audit trails
- Validate inputs
</all>

<@architect>
Architects should:
- Design with scalability
- Plan for failures
</architect>

<@builder>
Builders should:
- Write tests first
- Document as you go
</builder>

Implementation

• src/governance/parser.rs - Tag parsing logic
• src/governance/guidance.rs - Rule representation
• Support markdown preservation
• Extensible for custom tags

Testing

• Unit tests for tag parsing
• Integration tests with real AGENTS.md
• Edge cases (malformed tags, nesting)

---

Related: #30 (Epic), #31 (Phase 1)
Labels: governance, parser, tags