# nick-vels/skills architecture

> Architecture diagram of the GitHub repository nick-vels/skills, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-04). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/nick-vels/skills
- Repository: https://github.com/nick-vels/skills

## Overview

Autopilot is an AI-agent skill that turns an explicitly supplied project idea or brief into a built project. Its workflow moves from setup and clarification through specification and task planning, then implementation, review/repair, and final acceptance. The skill documents modes, depth controls, resume/memory, subagents, and a live dashboard. `ap.py` supports run state, tickets, requirement tracking, and dashboard serving; `measure-run.py` analyzes Claude Code session logs. The phase and prompt files are present in the tree but were not sampled, so their internal call relationships are not asserted.

Main entry points: [`skills/autopilot/SKILL.md`](https://github.com/nick-vels/skills/blob/main/skills/autopilot/SKILL.md) (Autopilot command), [`skills/autopilot/phases/5-subagents.md`](https://github.com/nick-vels/skills/blob/main/skills/autopilot/phases/5-subagents.md) (Task execution), [`skills/autopilot/tools/ap.py`](https://github.com/nick-vels/skills/blob/main/skills/autopilot/tools/ap.py) (Run state and tickets), [`tools/measure-run.py`](https://github.com/nick-vels/skills/blob/main/tools/measure-run.py) (Run measurement)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_workflow["Project workflow"]
  node_setup["Preflight and modes"]
  node_brief["Briefing and questions<br/>[2-briefing.md]"]
  node_spec["Specification<br/>[3-spec.md]"]
  node_plan["Task planning<br/>[4-plan.md]"]
  node_build["Task execution<br/>[5-subagents.md]"]
  node_repair["Review and repair<br/>[6-review.md]"]
  node_accept["Final acceptance<br/>[8-final.md]"]
  node_project["Generated project"]
end

subgraph group_skill["Skill guidance"]
  node_entry["Autopilot command<br/>[SKILL.md]"]
  node_memory["Project memory<br/>[9-memory.md]"]
  node_prompts["Agent prompts"]
  node_instrumentation["Instrument guidance<br/>[0-instruments.md]"]
end

subgraph group_runops["Run state and visibility"]
  node_runstate["Run state and tickets<br/>[ap.py]"]
  node_dashboard["Live dashboard"]
  node_artifacts[("Run artifacts")]
end

subgraph group_analysis["Run analysis"]
  node_sessionlogs[("Claude session logs")]
  node_measurement["Run measurement<br/>[measure-run.py]"]
end

node_user(("Project requester"))

node_user -->|"starts explicitly"| node_entry
node_entry -->|"begins with"| node_setup
node_setup -.->|"configures"| node_brief
node_brief -.->|"informs"| node_spec
node_spec -.->|"breaks into"| node_plan
node_plan -.->|"assigns tasks"| node_build
node_build -.->|"builds"| node_project
node_repair -.->|"requests fixes"| node_build
node_build -.->|"submits result"| node_accept
node_entry -.->|"maintains"| node_memory
node_entry -.->|"uses prompts"| node_prompts
node_entry -.->|"documents"| node_instrumentation
node_runstate -->|"writes state"| node_artifacts
node_runstate -->|"serves"| node_dashboard
node_measurement -->|"reads logs"| node_sessionlogs
node_measurement -->|"summarizes usage"| node_measurement
node_entry -.->|"records events"| node_runstate

click node_entry "https://github.com/nick-vels/skills/blob/main/skills/autopilot/SKILL.md"
click node_setup "https://github.com/nick-vels/skills/tree/main/skills/autopilot/phases"
click node_brief "https://github.com/nick-vels/skills/blob/main/skills/autopilot/phases/2-briefing.md"
click node_spec "https://github.com/nick-vels/skills/blob/main/skills/autopilot/phases/3-spec.md"
click node_plan "https://github.com/nick-vels/skills/blob/main/skills/autopilot/phases/4-plan.md"
click node_build "https://github.com/nick-vels/skills/blob/main/skills/autopilot/phases/5-subagents.md"
click node_repair "https://github.com/nick-vels/skills/blob/main/skills/autopilot/phases/6-review.md"
click node_accept "https://github.com/nick-vels/skills/blob/main/skills/autopilot/phases/8-final.md"
click node_memory "https://github.com/nick-vels/skills/blob/main/skills/autopilot/phases/9-memory.md"
click node_prompts "https://github.com/nick-vels/skills/tree/main/skills/autopilot/prompts"
click node_instrumentation "https://github.com/nick-vels/skills/blob/main/skills/autopilot/phases/0-instruments.md"
click node_runstate "https://github.com/nick-vels/skills/blob/main/skills/autopilot/tools/ap.py"
click node_dashboard "https://github.com/nick-vels/skills/blob/main/skills/autopilot/phases/dashboard-template.html"
click node_measurement "https://github.com/nick-vels/skills/blob/main/tools/measure-run.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_setup,node_brief,node_spec,node_plan,node_build,node_repair,node_accept,node_project toneBlue
class node_entry,node_memory,node_prompts,node_instrumentation toneAmber
class node_runstate,node_dashboard,node_artifacts,node_user toneMint
class node_sessionlogs,node_measurement toneRose
```

## Components

### Project workflow

- [Preflight and modes](https://github.com/nick-vels/skills/tree/main/skills/autopilot/phases): `skills/autopilot/phases`
- [Briefing and questions](https://github.com/nick-vels/skills/blob/main/skills/autopilot/phases/2-briefing.md): `skills/autopilot/phases/2-briefing.md`
- [Specification](https://github.com/nick-vels/skills/blob/main/skills/autopilot/phases/3-spec.md): `skills/autopilot/phases/3-spec.md`
- [Task planning](https://github.com/nick-vels/skills/blob/main/skills/autopilot/phases/4-plan.md): `skills/autopilot/phases/4-plan.md`
- [Task execution](https://github.com/nick-vels/skills/blob/main/skills/autopilot/phases/5-subagents.md): `skills/autopilot/phases/5-subagents.md`
- [Review and repair](https://github.com/nick-vels/skills/blob/main/skills/autopilot/phases/6-review.md): `skills/autopilot/phases/6-review.md`
- [Final acceptance](https://github.com/nick-vels/skills/blob/main/skills/autopilot/phases/8-final.md): `skills/autopilot/phases/8-final.md`
- **Generated project**

### Skill guidance

- [Autopilot command](https://github.com/nick-vels/skills/blob/main/skills/autopilot/SKILL.md): `skills/autopilot/SKILL.md`
- [Project memory](https://github.com/nick-vels/skills/blob/main/skills/autopilot/phases/9-memory.md): `skills/autopilot/phases/9-memory.md`
- [Agent prompts](https://github.com/nick-vels/skills/tree/main/skills/autopilot/prompts): `skills/autopilot/prompts`
- [Instrument guidance](https://github.com/nick-vels/skills/blob/main/skills/autopilot/phases/0-instruments.md): `skills/autopilot/phases/0-instruments.md`

### Run state and visibility

- [Run state and tickets](https://github.com/nick-vels/skills/blob/main/skills/autopilot/tools/ap.py): `skills/autopilot/tools/ap.py`
- [Live dashboard](https://github.com/nick-vels/skills/blob/main/skills/autopilot/phases/dashboard-template.html): `skills/autopilot/phases/dashboard-template.html`
- **Run artifacts**

### Run analysis

- **Claude session logs**
- [Run measurement](https://github.com/nick-vels/skills/blob/main/tools/measure-run.py): `tools/measure-run.py`

### Other components

- **Project requester**

## Connections

- Project requester → Autopilot command: starts explicitly (evidence: `README.md`)
- Autopilot command → Preflight and modes: begins with (evidence: `README.md`)
- Preflight and modes → Briefing and questions: configures
- Briefing and questions → Specification: informs
- Specification → Task planning: breaks into
- Task planning → Task execution: assigns tasks
- Task execution → Generated project: builds
- Review and repair → Task execution: requests fixes
- Task execution → Final acceptance: submits result
- Autopilot command → Project memory: maintains
- Autopilot command → Agent prompts: uses prompts
- Autopilot command → Instrument guidance: documents
- Run state and tickets → Run artifacts: writes state (evidence: `skills/autopilot/tools/ap.py`)
- Run state and tickets → Live dashboard: serves (evidence: `skills/autopilot/tools/ap.py`)
- Run measurement → Claude session logs: reads logs (evidence: `tools/measure-run.py`)
- Run measurement → Run measurement: summarizes usage (evidence: `tools/measure-run.py`)
- Autopilot command → Run state and tickets: records events
