How funnel-futurist/ff-aios-starter works
AIOS is a user-owned Claude Code operating system for a business: repository files retain context, decisions, procedures, and work products, while named skills guide recurring tasks. The main path is onboarding, building business context, then using a skill to act on a real task and review its output. The workspace, quality controls, and setup/maintenance tooling support that loop. The README documents capabilities whose source wiring was not sampled; those are shown as separate branches where their paths are supported, without assuming internal call chains.
Main entry points: aios.py AIOS command line · skills Task skills · workspace.py Workspace Kit · SKILL.md Onboarding wizard
Components 21
Operator workflow
- Session constitution
CLAUDE.md - Onboarding wizard
.claude/skills/onboard_wizard/SKILL.md - Task skills
.claude/skills - Unstuck protocol
docs/UNSTUCK_PROTOCOL.md
Business workspace
- Business foundations
01_Foundations - Work deliverables
02_Deliverables - Customer journey
04_Customer_Journey - Operating records
06_Communication - Projects
11_Projects
Quality and review
- QC preferences and rubric
03_Quality_Control - PR static checks
scripts/pr_review/static_checks.mjs - Skill contract checks
scripts/verify_skills.py
Install and governance
- AIOS command line
scripts/aios/aios.py - Release manifests
scripts/aios/aioslib/release.py - Install lifecycle
scripts/aios/aioslib/install.py - Workspace Kit
scripts/aios/aioslib/workspace.py - Role boundaries
scripts/aios/aioslib/boundary.py
External tools
- Claude Code
- Obsidian vault
- Git repositories
Other components
- Business operator
Connections 23
- Business operator → Claude Code: works in
- Claude Code → Session constitution: reads first
- Business operator → Onboarding wizard: starts with
- Claude Code → Onboarding wizard: runs skill
- Onboarding wizard → Business foundations: loads context
- Business operator → Task skills: selects task
- Claude Code → Task skills: runs skill
- Task skills → Business foundations: uses context
- Task skills → Work deliverables: produces work
- Business operator → QC preferences and rubric: reviews against
- Business operator → Unstuck protocol: consults when stuck
- Business operator → Customer journey: tracks progress
- Business operator → Operating records: records decisions
- Business operator → Projects: organizes work
- PR static checks → QC preferences and rubric: checks changes
- Skill contract checks → Task skills: validates structure
- Business operator → AIOS command line: runs commands
- AIOS command line → Release manifests: checks release
- AIOS command line → Install lifecycle: installs or verifies
- AIOS command line → Workspace Kit: manages workspace
- AIOS command line → Role boundaries: checks role
- Workspace Kit → Obsidian vault: builds vault
- Workspace Kit → Git repositories: syncs repositories