Skip to main content
This guide walks you through the full Skaro workflow for a brand new project — from initialization to completing your first feature.

​
Prerequisites

  • Skaro installed (Installation)
  • An LLM provider API key (or Ollama running locally)

​
Step 1: Initialize

Create a project directory and initialize Skaro:
Walk through the wizard: choose language, accept the license, confirm the project name. Since this is a new directory, Skaro creates the standard .skaro/ structure.

​
Step 2: Configure LLM

Verify it works:
The “API Key Resolved” field should show ✓.

​
Step 3: Write the Constitution

Open .skaro/constitution.md in your editor (or use the dashboard). Replace the template with your actual project principles. At minimum, fill in these six sections:
Validate completeness:
All six checks should show ✓.

​
Step 4: Launch the Dashboard

From here, everything happens in the browser.

​
Step 5: Define Architecture

In the dashboard, go to Architecture and describe your system:
  • Component overview (frontend, API, database)
  • Key data flows
  • Technology decisions and their rationale
Then request an Architecture Review — the LLM will analyze your design and report risks. Review the findings, define invariants (rules that must always hold), and create ADRs for non-obvious decisions.

​
Step 6: Generate a Dev Plan

Go to Dev Plan and generate a plan. The LLM reads your constitution and architecture, then proposes milestones and tasks. For example:
Review and approve the plan. Tasks will appear in the Tasks section.

​
Step 7: Work on Your First Task

Select a task and step through the phases:

​
Clarify

The LLM reads your spec and asks clarifying questions: edge cases, missing requirements, contradictions with invariants. Answer each question — your responses are saved to clarifications.md.

​
Plan

The LLM decomposes the task into implementation stages. Each stage has a goal, inputs/outputs, and Definition of Done. Review the plan for realism — no stage should take more than one working day.

​
Implement

Stage by stage, the LLM generates code. For each stage:
  1. Review the generated files
  2. Apply them to your project
  3. Check that AI_NOTES.md accurately describes what was done and why

​
Tests

Run your verification commands (configured in the dashboard settings). The LLM can also generate additional tests. If issues are found, use the fix chat to address them iteratively. This completes the task pipeline. When all tasks in a milestone are done, you can run a Project Review from the dashboard to cross-validate the entire codebase against the spec, architecture, and constitution.

​
Step 8: Commit

Once tests pass, commit everything to Git:
The .skaro/ artifacts are committed alongside your code — the full context is preserved for future tasks.

​
Repeat

Pick the next task and repeat steps 7–8. Each task builds on the context from previous ones. The constitution, architecture, and invariants guide every LLM call, keeping your project consistent as it grows.