1. Introduction
5. User Guide
6. 1. Getting Started
7. 2. Working with RFCs
8. 3. Working with ADRs
9. 4. Working with Work Items
10. 5. Validation & Rendering
12. Specifications
13. 6. RFC-0000: govctl Governance Framework
14. 7. RFC-0001: Lifecycle State Machines
15. 8. RFC-0002: CLI Resource Model and Command Architecture
16. 9. RFC-0003: TUI UX improvements
17. 10. RFC-0004: Concurrent write safety for governance artifacts
19. Decisions
20. 11. ADR-0001: Use TOML for ADRs and Work Items
21. 12. ADR-0002: Fix artifact lifecycle design flaws
22. 13. ADR-0003: Deterministic hash signatures for rendered projections
23. 14. ADR-0004: Adopt Keep a Changelog format for RFC changelogs
24. 15. ADR-0005: CLI output color scheme and formatting
25. 16. ADR-0006: Global dry-run support for content-modifying commands
26. 17. ADR-0007: Ergonomic array field matching for remove and tick commands
27. 18. ADR-0008: Add refs field to RfcSpec for artifact cross-referencing
28. 19. ADR-0009: Configurable source code reference scanning
29. 20. ADR-0010: Validate work item descriptions for placeholder content
30. 21. ADR-0011: Inline reference expansion in rendered content
31. 22. ADR-0012: Prefix-based changelog category parsing
32. 23. ADR-0013: Add category field to acceptance criteria for changelog generation
33. 24. ADR-0014: Release management with releases.toml
34. 25. ADR-0015: Context-aware self-describing CLI for agent discoverability
35. 26. ADR-0016: Allow RFC amendments via versioning during implementation
36. 27. ADR-0017: CLI Command Implementation Details
37. 28. ADR-0018: Global Command Shortcuts vs Strict Resource-First Syntax
38. 29. ADR-0019: Change -n from dry-run to limit for better Unix convention alignment
39. 30. ADR-0020: Configurable work item ID strategies for multi-person collaboration
40. 31. ADR-0021: Resource-scoped render commands for single-item rendering
41. 32. ADR-0022: Add show command for stdout rendering
42. 33. ADR-0023: Organize assets into commands, skills, and agents subdirectories
43. 34. ADR-0024: Writers as skills, reviewers as agents for governance artifacts
44. 35. ADR-0025: Concurrent write safety for agent-driven parallel tasks
45. 36. ADR-0026: Add journal field to WorkItem for execution tracking
46. 37. ADR-0027: Extend Alternative structure with pros, cons, and rejection_reason
47. 38. ADR-0028: Migrate commands to skills format for cross-platform compatibility
48. 39. ADR-0029: Path-based nested field addressing for artifact edits
49. 40. ADR-0030: Parser strategy for path-based field expressions
50. 41. ADR-0031: Unified Artifact Edit Engine with SSOT and Format Adapters
51. 42. ADR-0032: Migration skill for adopting govctl in existing projects
52. 43. ADR-0033: Distribute govctl agent integration as Claude Code plugin
53. 44. ADR-0034: Use TOML as the canonical storage format for all governance artifacts
54. 45. ADR-0035: Decouple skill and agent installation from project initialization
55. 46. ADR-0036: Restructure ADR chosen-option and migration semantics
56. 47. ADR-0037: Canonical edit surface for nested artifact mutation
57. 48. ADR-0038: Keep ADR schema discussion-oriented and avoid broad migration
58. 49. ADR-0039: Use SQLite FTS5 as read-only search index for governance artifacts
59. 50. ADR-0040: Controlled-vocabulary tags for governance artifacts
60. 51. ADR-0041: Self-update and cargo-binstall binary distribution
61. 52. ADR-0042: Enforce ADR writing order with structural gates