How theblackcat98/pags works
PAGS equips a repository with agent-workflow records, an installer, and a checker. The main workflow is: a maintainer installs the records, an agent uses them to guide and document changes, and the checker validates their consistency. The README documents adoption profiles, greenfield/brownfield setup, and optional design records. Installer and checker internals are represented from sampled source; the agent loop and record roles come from the README and templates, so their runtime wiring is shown only where documented.
Main entry points: install-pags.py Installer · .pags-templates Record updates · pags-check.py Records checker · AGENTS.md Agent change loop
Components 19
Adoption
- Installer
scripts/install-pags.py - Adoption setup
scripts/install-pags.py
Project records
- Record templates
.pags-templates - Agent guide
.pags-templates/AGENTS.md - Charter
.pags-templates/CHARTER.md - Work records
.pags-templates/WORK.md - Decisions
.pags-templates/DECISIONS.md - Architecture record
.pags-templates/ARCHITECTURE.md - Design record
.pags-templates/DESIGN.md - User README
.pags-templates/README.md
Agent workflow
- Agent change loop
.pags-templates/AGENTS.md - Record updates
.pags-templates
Consistency checks
- Records checker
scripts/pags-check.py - Parse records
scripts/pags-check.py - Consistency rules
scripts/pags-check.py - Check result
scripts/pags-check.py
Other components
- Maintainer
- Target repository
- Coding agent
Connections 18
- Maintainer → Installer: runs install
- Installer → Adoption setup: detects profile
- Installer → Record templates: reads templates
- Installer → Target repository: writes selected files
- Maintainer → Agent guide: sets agent rules
- Coding agent → Agent change loop: follows workflow
- Agent change loop → Target repository: reads project records
- Agent change loop → Record updates: updates records
- Record updates → Work records: records outcomes and tasks
- Record updates → Decisions: records choices
- Record updates → Architecture record: records current system
- Maintainer → Charter: approves boundaries
- Coding agent → Records checker: runs check
- Records checker → Target repository: reads records
- Records checker → Parse records: parses entries
- Parse records → Consistency rules: checks parsed entries
- Consistency rules → Check result: produces findings
- Records checker → Coding agent: reports findings