How jamillazarev/opsinist works
Opsinist is a repository-based operating system for AI-agent teams: its skills and Markdown corpus describe company operations, while scripts and hooks provide selected enforcement and project-management functions. The documented user workflow starts with a natural-language request routed through the advisor, then enters an appropriate flow such as project initiation, takeover audit, backlog mapping, or task work. The graph preserves major documented capabilities as domain branches. Source excerpts are partial, so links between unsampled skill chapters and runtime helpers are omitted unless the README or excerpts support them.
Main entry points: SKILL.md Advisor skill · skills Agent skills · new-task.py Task creation · check-structure.py Project validators
Components 21
Skills and entrypoints
- Advisor skill
skills/advisor/SKILL.md - Agent skills
skills - Claude plugin
.claude-plugin/plugin.json - OpenCode plugin
.opencode/plugins/opsinist.js - Pi extension
.pi/extensions/opsinist.ts
Work lifecycle
- Operations chapters
starting.md - Task creation
scripts/new-task.py - Task records
- Task board
scripts/board.py - Stage transition
scripts/transition.py
Governance and evidence
- Takeover audit
hooks/audit-gate.py - Dependency review
scripts/deps-report.py - Source intake
scripts/fetch-source.py - Cost management
cost.md - Release practice
shipping.md - Layout migration
scripts/migrate-layout.py
Runtime enforcement
- Audit hook
hooks/audit-gate.py - Project validators
scripts/check-structure.py - Enforcement map
scripts/coverage-map.py
Other components
- Operator
- Project repository
Connections 19
- Operator → Advisor skill: asks for work
README.md - Advisor skill → Agent skills: routes requests
README.md - Agent skills → Operations chapters: loads guidance
- Operator → Task creation: requests a task
- Task creation → Task records: writes task
scripts/new-task.py - Task board → Task records: reads tasks
scripts/board.py - Stage transition → Task records: updates stage
scripts/transition.py - Operator → Takeover audit: starts takeover
- Dependency review → Project repository: inspects dependencies
scripts/deps-report.py - Source intake → Project repository: maintains sources
scripts/fetch-source.py - Layout migration → Project repository: moves project files
scripts/migrate-layout.py - Audit hook → Project repository: checks run state
- Project validators → Project repository: checks structure
scripts/check-structure.py - Enforcement map → Project validators: catalogues holders
scripts/coverage-map.py - Operator → Cost management: plans spending
- Operator → Release practice: plans release
- Operator → Claude plugin: installs plugin
README.md - Operator → OpenCode plugin: uses runtime
README.md - Operator → Pi extension: uses runtime
README.md