# riddhimjainsandeep-eng/build-task architecture

> Architecture diagram of the GitHub repository riddhimjainsandeep-eng/build-task, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-27). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/riddhimjainsandeep-eng/build-task
- Repository: https://github.com/riddhimjainsandeep-eng/build-task

## Overview

build-task is a Claude Code plugin that guides a user through code changes and first-run project setup. The default task workflow has six documented stages, from cited exploration through implementation, external proof, independent review, reporting, and close-out. It also offers v1 and experimental fast variants, configurable v2 behavior, cross-project history, and plugin updates. Edges reflect README-documented behavior; source excerpts were unavailable, so uncertain internal wiring is omitted.

Main entry points: [`skills/build-task-v2/SKILL.md`](https://github.com/riddhimjainsandeep-eng/build-task/blob/main/skills/build-task-v2/SKILL.md) (Explore), [`commands/build.md`](https://github.com/riddhimjainsandeep-eng/build-task/blob/main/commands/build.md) (Build command), [`skills/build-task-v2/phases/report-and-close.md`](https://github.com/riddhimjainsandeep-eng/build-task/blob/main/skills/build-task-v2/phases/report-and-close.md) (Report), [`skills/build-setup/SKILL.md`](https://github.com/riddhimjainsandeep-eng/build-task/blob/main/skills/build-setup/SKILL.md) (Setup command)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_workflow["Task workflows"]
  node_build_cmd["Build command<br/>[build.md]"]
  node_v2["Default v2<br/>[SKILL.md]"]
  node_explore["Explore<br/>[SKILL.md]"]
  node_implement["Implement<br/>[SKILL.md]"]
  node_prove["Prove<br/>[SKILL.md]"]
  node_review["Review<br/>[SKILL.md]"]
  node_report["Report"]
  node_closeout["Close out"]
  node_v1["Original v1<br/>[SKILL.md]"]
  node_fast["Fast variant<br/>[SKILL.md]"]
  node_settings["V2 settings<br/>[settings.sh]"]
end

subgraph group_project["Project setup"]
  node_setup_cmd["Setup command<br/>[SKILL.md]"]
  node_setup_templates["Project scaffolding"]
end

subgraph group_shared["Shared services"]
  node_history_cmd["History command<br/>[build-history.md]"]
  node_history_skill["History workflow<br/>[history.sh]"]
  node_history_store[("Shared history<br/>[schema.sql]")]
  node_plugin_update["Plugin update<br/>[update.sh]"]
end

node_user(("User"))

node_user -->|"starts task"| node_build_cmd
node_build_cmd -->|"runs by default"| node_v2
node_user -->|"chooses variant"| node_v1
node_user -->|"chooses variant"| node_fast
node_v2 -->|"begins with"| node_explore
node_explore -->|"then implements"| node_implement
node_implement -->|"then proves"| node_prove
node_prove -->|"then reviews"| node_review
node_review -->|"then reports"| node_report
node_report -->|"then closes"| node_closeout
node_user -->|"runs setup"| node_setup_cmd
node_setup_cmd -->|"creates scaffolding"| node_setup_templates
node_user -->|"requests history"| node_history_cmd
node_history_cmd -->|"invokes"| node_history_skill
node_explore -->|"reads history"| node_history_store
node_closeout -->|"logs entry"| node_history_store
node_user -->|"configures v2"| node_settings
node_user -->|"requests update"| node_plugin_update

click node_build_cmd "https://github.com/riddhimjainsandeep-eng/build-task/blob/main/commands/build.md"
click node_v2 "https://github.com/riddhimjainsandeep-eng/build-task/blob/main/skills/build-task-v2/SKILL.md"
click node_explore "https://github.com/riddhimjainsandeep-eng/build-task/blob/main/skills/build-task-v2/SKILL.md"
click node_implement "https://github.com/riddhimjainsandeep-eng/build-task/blob/main/skills/build-task-v2/SKILL.md"
click node_prove "https://github.com/riddhimjainsandeep-eng/build-task/blob/main/skills/build-task-v2/SKILL.md"
click node_review "https://github.com/riddhimjainsandeep-eng/build-task/blob/main/skills/build-task-v2/SKILL.md"
click node_report "https://github.com/riddhimjainsandeep-eng/build-task/blob/main/skills/build-task-v2/phases/report-and-close.md"
click node_closeout "https://github.com/riddhimjainsandeep-eng/build-task/blob/main/skills/build-task-v2/phases/report-and-close.md"
click node_v1 "https://github.com/riddhimjainsandeep-eng/build-task/blob/main/skills/build-task/SKILL.md"
click node_fast "https://github.com/riddhimjainsandeep-eng/build-task/blob/main/skills/build-task-fast/SKILL.md"
click node_setup_cmd "https://github.com/riddhimjainsandeep-eng/build-task/blob/main/skills/build-setup/SKILL.md"
click node_setup_templates "https://github.com/riddhimjainsandeep-eng/build-task/tree/main/skills/build-setup/templates"
click node_history_cmd "https://github.com/riddhimjainsandeep-eng/build-task/blob/main/commands/build-history.md"
click node_history_skill "https://github.com/riddhimjainsandeep-eng/build-task/blob/main/skills/build-task/scripts/history.sh"
click node_history_store "https://github.com/riddhimjainsandeep-eng/build-task/blob/main/db/schema.sql"
click node_settings "https://github.com/riddhimjainsandeep-eng/build-task/blob/main/skills/build-task-v2/scripts/settings.sh"
click node_plugin_update "https://github.com/riddhimjainsandeep-eng/build-task/blob/main/scripts/update.sh"

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_build_cmd,node_v2,node_explore,node_implement,node_prove,node_review,node_report,node_closeout,node_v1,node_fast,node_settings,node_user toneBlue
class node_setup_cmd,node_setup_templates toneAmber
class node_history_cmd,node_history_skill,node_history_store,node_plugin_update toneMint
```

## Components

### Task workflows

- [Build command](https://github.com/riddhimjainsandeep-eng/build-task/blob/main/commands/build.md): `commands/build.md`
- [Default v2](https://github.com/riddhimjainsandeep-eng/build-task/blob/main/skills/build-task-v2/SKILL.md): `skills/build-task-v2/SKILL.md`
- [Explore](https://github.com/riddhimjainsandeep-eng/build-task/blob/main/skills/build-task-v2/SKILL.md): `skills/build-task-v2/SKILL.md`
- [Implement](https://github.com/riddhimjainsandeep-eng/build-task/blob/main/skills/build-task-v2/SKILL.md): `skills/build-task-v2/SKILL.md`
- [Prove](https://github.com/riddhimjainsandeep-eng/build-task/blob/main/skills/build-task-v2/SKILL.md): `skills/build-task-v2/SKILL.md`
- [Review](https://github.com/riddhimjainsandeep-eng/build-task/blob/main/skills/build-task-v2/SKILL.md): `skills/build-task-v2/SKILL.md`
- [Report](https://github.com/riddhimjainsandeep-eng/build-task/blob/main/skills/build-task-v2/phases/report-and-close.md): `skills/build-task-v2/phases/report-and-close.md`
- [Close out](https://github.com/riddhimjainsandeep-eng/build-task/blob/main/skills/build-task-v2/phases/report-and-close.md): `skills/build-task-v2/phases/report-and-close.md`
- [Original v1](https://github.com/riddhimjainsandeep-eng/build-task/blob/main/skills/build-task/SKILL.md): `skills/build-task/SKILL.md`
- [Fast variant](https://github.com/riddhimjainsandeep-eng/build-task/blob/main/skills/build-task-fast/SKILL.md): `skills/build-task-fast/SKILL.md`
- [V2 settings](https://github.com/riddhimjainsandeep-eng/build-task/blob/main/skills/build-task-v2/scripts/settings.sh): `skills/build-task-v2/scripts/settings.sh`

### Project setup

- [Setup command](https://github.com/riddhimjainsandeep-eng/build-task/blob/main/skills/build-setup/SKILL.md): `skills/build-setup/SKILL.md`
- [Project scaffolding](https://github.com/riddhimjainsandeep-eng/build-task/tree/main/skills/build-setup/templates): `skills/build-setup/templates`

### Shared services

- [History command](https://github.com/riddhimjainsandeep-eng/build-task/blob/main/commands/build-history.md): `commands/build-history.md`
- [History workflow](https://github.com/riddhimjainsandeep-eng/build-task/blob/main/skills/build-task/scripts/history.sh): `skills/build-task/scripts/history.sh`
- [Shared history](https://github.com/riddhimjainsandeep-eng/build-task/blob/main/db/schema.sql): `db/schema.sql`
- [Plugin update](https://github.com/riddhimjainsandeep-eng/build-task/blob/main/scripts/update.sh): `scripts/update.sh`

### Other components

- **User**

## Connections

- User → Build command: starts task
- Build command → Default v2: runs by default
- User → Original v1: chooses variant
- User → Fast variant: chooses variant
- Default v2 → Explore: begins with
- Explore → Implement: then implements
- Implement → Prove: then proves
- Prove → Review: then reviews
- Review → Report: then reports
- Report → Close out: then closes
- User → Setup command: runs setup
- Setup command → Project scaffolding: creates scaffolding
- User → History command: requests history
- History command → History workflow: invokes
- Explore → Shared history: reads history
- Close out → Shared history: logs entry
- User → V2 settings: configures v2
- User → Plugin update: requests update