Bootstrap

For existing codebases, trurlic bootstrap populates the decision graph autonomously. A coding agent reads the source code and records components, decisions, and patterns — no interactive dialogue needed.

Quick start

trurlic init
trurlic bootstrap       # shows status and agent instructions
trurlic serve           # start MCP server
# In your coding agent:
#   advance(component="project", task_type="bootstrap")
#   follow each step until ready: true
trurlic map             # review the result

How it works

Bootstrap is a two-phase process:

Phase 1: trurlic bootstrap — prints the current status (which components have been bootstrapped, which haven’t) and the agent instructions for running the bootstrap workflow.

Phase 2: Agent runs the bootstrap workflow — the coding agent calls advance(component="project", task_type="bootstrap") and follows the returned steps. The bootstrap task type uses an autonomous step sequence: scan_project → extract_decisions → project_rules → pattern_detection → ready.

The agent reads source code, identifies components and architectural decisions, records them via record_decision and add_component, and synthesizes patterns. All decisions are attributed as agent — flagged for human review.

Bootstrap a single component

trurlic bootstrap auth

This scopes the bootstrap to a single component, useful for incremental extraction.

Direct bootstrap (no agent)

Use -p to run the bootstrap directly via the LLM API instead of printing agent instructions:

trurlic bootstrap -p anthropic
trurlic bootstrap auth -p openai -m gpt-4o

This is a convenience mode — it runs the same workflow but uses the session module’s LLM client directly instead of relying on the coding agent’s MCP calls.

Reviewing the result

All bootstrap-extracted decisions carry attribution = "agent" and are flagged with ⚠ in context briefs and the interactive map. Review them with:

trurlic map           # visual review in browser
trurlic status        # counts and health summary
trurlic check         # validate graph integrity

Convert agent-attributed decisions to human-attributed by revisiting them:

trurlic design auth --revisit

The revisit flow walks through existing decisions, letting you confirm, modify, or reject each one.