How julian-b-smith/autonomous works
autonomous is a standards body, toolkit, and control room for developing and governing a fleet of AI-built software projects. The principal loop is human-directed work by an implementer, independent verification and criticism, deterministic gates, then fleet-wide oversight and follow-up. The graph also preserves the documented session, kit-distribution, coordination, and memory-loop capabilities. Several subsystems are documented but not sampled in source; those links use README evidence, and the coordination layer is described as designed rather than built.
Main entry points: monitor.py Fleet monitor · sweep.py Fleet sweep · harness Agent harness · retrofit_verify.py Retrofit verification
Components 25
Doctrine and harness
- Standing doctrine
doctrine/DOCTRINE.md - Agent harness
harness - Harness kit
kit - Verify oracle
kit/templates/verify.project
Session operations
- Session state
kit/session/state.py - Session facts
kit/hooks/session_facts.py - Session registry
kit/session/registry.py - Session board
kit/session/render_registry.py - Fleet session close
kit/session/batch_close.py
Fleet coordination
- Threads board
kit/session/render_threads.py - Fleet sweep
kit/sweep/sweep.py - Kit synchronization
kit/kit_sync.py - Kit currency audit
kit/currency.py - Fleet checklist
kit/render_checklist.py
Deterministic governance
- Mailbox obligations
governor/ball_scan.py - Fleet monitor
governor/monitor.py - Leak scan
governor/leak_scan.py - S4 scan
governor/s4_scan.py - Retrofit verification
governor/retrofit_verify.py - Session brief hook
kit/hooks/session-brief.py
Memory loops
- Knowledge loop
loops/knowledge-loop - Audit loop
loops/audit-loop
Other components
- Human operator
- Coding agents
- Project repositories
Connections 31
- Human operator → Coding agents: directs work
README.md - Coding agents → Agent harness: work within
README.md - Agent harness → Project repositories: implements changes
README.md - Agent harness → Verify oracle: runs oracle
README.md - Verify oracle → Project repositories: checks tree
README.md - Standing doctrine → Agent harness: sets rules
README.md - Harness kit → Project repositories: vendors mechanism
README.md - Project repositories → Session facts: provides git facts
kit/hooks/session_facts.py - Session facts → Session registry: records session
- Session state → Project repositories: reads repo state
kit/session/state.py - Session board → Session registry: renders open sessions
kit/session/render_registry.py - Session brief hook → Mailbox obligations: scans obligations
kit/hooks/session-brief.py - Session brief hook → Retrofit verification: verifies notices
kit/hooks/session-brief.py - Threads board → Fleet sweep: resolves projects
kit/session/render_threads.py - Threads board → Mailbox obligations: scans threads
kit/session/render_threads.py - Fleet sweep → Project repositories: enumerates fleet
kit/sweep/sweep.py - Kit synchronization → Project repositories: syncs kit files
kit/kit_sync.py - Fleet checklist → Kit synchronization: checks vendoring
kit/render_checklist.py - Fleet checklist → Fleet sweep: reads fleet status
- Retrofit verification → Kit currency audit: reads currency
governor/retrofit_verify.py - Retrofit verification → Project repositories: rechecks claims
governor/retrofit_verify.py - Fleet monitor → Leak scan: runs scan
governor/monitor.py - Fleet monitor → Mailbox obligations: runs scan
governor/monitor.py - Fleet monitor → S4 scan: runs scan
governor/monitor.py - Fleet monitor → Fleet sweep: reads fleet
governor/monitor.py - Fleet session close → Session state: reads state
kit/session/batch_close.py - Fleet session close → Fleet sweep: closes fleet sessions
kit/session/batch_close.py - Human operator → Fleet monitor: reviews findings
README.md - Knowledge loop → Project repositories: promotes lessons
README.md - Audit loop → Project repositories: down-propagates lessons
README.md - Human operator → Knowledge loop: ratifies learning
README.md