Back
10/61
Lesson 10
10 min

The Flywheel Loop

Put it all together for maximum velocity

New to ACFS?

Complete the setup wizard first to get the most from these lessons.

Go to Choose Your OS
Goal

Understand how all the tools work together.

The ACFS Flywheel

This isn't just a collection of tools. It's a compounding loop:

ACFSFlywheelPlanBeadsCoordinateAgent MailExecuteNTM + AgentsScanUBSRememberCASS MemoryGuardDCG + SLB

Each cycle makes the next one better.

The Twenty Tools (And When To Use Them)

1. NTM

- Your Cockpit
ntm

Use it to:

  • Spawn agent sessions
  • Send prompts to multiple agents
  • Orchestrate parallel work

2. MCP Agent Mail

- Coordination
am

Use it to:

  • Multiple agents need to share context
  • You want agents to "talk" to each other
  • Coordinating complex multi-agent workflows

3. UBS

- Quality Guardrails
ubs

Use it to:

  • Scan code for bugs before committing
  • Run comprehensive static analysis
  • Catch issues early
ubs .  # Scan current directory

4. CASS

- Session Search
cass

Use it to:

  • Search across all agent session history
  • Find previous solutions
  • Review what agents have done
cass search "authentication error" --robot --limit 5

5. CASS Memory (CM)

- Procedural Memory
cm

Use it to:

  • Build persistent agent memory
  • Distill learnings from sessions
  • Give agents context from past work
cm context "Building an API"  # Get relevant memories
cm reflect                     # Update procedural memory

6. Beads Viewer

- Task Management
bv

Use it to:

  • Track tasks and issues
  • Kanban view of work
  • Keep agents focused on goals
bv --robot-triage  # Deterministic triage output

7. CAAM

- Account Switching
caam

Use it to:

  • You hit rate limits
  • You want to switch between accounts
  • Testing with different credentials
caam status         # See current accounts
caam activate claude backup-account

8. SLB

- Safety Guardrails
slb

Use it to:

  • Dangerous commands (when you want them reviewed)
  • Two-person rule for destructive operations
  • Optional safety layer

9. RU

- Multi-Repo Sync
ru

Use it to:

  • Sync dozens of repos with one command
  • AI-driven commit automation
  • Parallel workflow management
ru sync -j4                  # Parallel sync
ru agent-sweep --dry-run    # Preview AI commits

10. DCG

- Pre-Execution Guard
dcg

Use it to:

  • Blocks dangerous commands before execution
  • Protects git, filesystem, and databases
  • Automatic - no manual calls needed
dcg test "rm -rf /" --explain  # Test if blocked
dcg doctor                     # Check status

A Complete Workflow

Here's how a real session might look:

bash
1# 1. Plan your work
2bv --robot-triage                # Check tasks
3br ready                        # See what's ready to work on
4
5# 2. Start your agents
6ntm spawn myproject --cc=2 --cod=1
7
8# 3. Set context
9cm context "Implementing user authentication" --json
10
11# 4. Send initial prompt
12ntm send myproject "Let's implement user authentication.
13Here's the context: [paste cm output]"
14
15# 5. Monitor and guide
16ntm attach myproject            # Watch progress
17
18# 6. Scan before committing
19ubs .                           # Check for bugs
20
21# 7. Update memory
22cm reflect                      # Distill learnings
23
24# 8. Close the task
25br close <task-id>

The Flywheel Effect

With each cycle:

CASS remembers what worked
CM distills reusable patterns
UBS catches more issues
DCG blocks before damage happens
Agent Mail improves coordination
NTM sessions become more effective
The Flywheel in Action
Cycle 1ยทCold start
Cycle 1Cold start4 hrsIde1/8Pla2/8Cod3/8Tes4/8Rev5/8Dep6/8Mon7/8Lea8/8

Identify Task

Stage 1 of 8

Scan the backlog, triage issues by priority, and pick the highest-impact task. Beads keeps everything ranked and visible.

Beads Viewer (bv)br ready
Note
This is why it's called a flywheel - it gets better the more you use it.

Your First Real Task

You're ready! Here's how to start your first project:

bash
1# 1. Create a project directory
2mkcd /data/projects/my-first-project
3
4# 2. Initialize git
5git init
6
7# 3. Initialize beads for task tracking
8br init
9
10# (Recommended) Create a dedicated Beads sync branch
11# Beads uses git worktrees for syncing; syncing to your current branch (often `main`)
12# can cause worktree conflicts. Once you have a `main` branch and a remote, run:
13git branch beads-sync main
14git push -u origin beads-sync
15br config set sync.branch=beads-sync
16
17# 4. Spawn your agents
18ntm spawn my-first-project --cc=2 --cod=1 --gmi=1
19
20# 5. Start building!
21ntm send my-first-project "Let's build something awesome.
22What kind of project should we create?"

Getting Help

acfs doctorCheck everything is working
ntm --helpNTM help
onboardRe-run this tutorial anytime

Ready to level up?

Mark complete to track your learning progress.