# challengepost/learn-ai-basics architecture

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

- Interactive diagram: https://gitdiagram.com/challengepost/learn-ai-basics
- Repository: https://github.com/challengepost/learn-ai-basics

## Overview

Learn AI Basics is a set of agent skills that guides a beginner from project idea to a small proof of concept and a Devpost submission. The principal workflow moves through onboarding, scoping, product requirements, technical planning, verified building, and shipping; learner-authored files in `devpost/` carry context and progress between conversations. Supporting templates and references shape those stages. The README documents this workflow and its outputs; no source excerpts were provided, so relationships shown here rely on that documentation.

Main entry points: [`skills/5-build/SKILL.md`](https://github.com/challengepost/learn-ai-basics/blob/main/skills/5-build/SKILL.md) (Build Skill), [`skills/6-ship/SKILL.md`](https://github.com/challengepost/learn-ai-basics/blob/main/skills/6-ship/SKILL.md) (Ship Skill), [`skills/3-prd/SKILL.md`](https://github.com/challengepost/learn-ai-basics/blob/main/skills/3-prd/SKILL.md) (PRD Skill), [`skills/4-spec/SKILL.md`](https://github.com/challengepost/learn-ai-basics/blob/main/skills/4-spec/SKILL.md) (Spec Skill)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_discover["Onboarding &amp; Scope"]
  node_start["Start Skill<br/>[SKILL.md]"]
  node_profile["Learner Profile"]
  node_scope["Scope Skill<br/>[SKILL.md]"]
  node_scope_doc["Scope Document<br/>[scope-template.md]"]
end

subgraph group_plan["Product Planning"]
  node_prd["PRD Skill<br/>[SKILL.md]"]
  node_prd_doc["PRD Document<br/>[prd-template.md]"]
  node_prd_guide["PRD Guide<br/>[prd-guide.md]"]
  node_spec["Spec Skill<br/>[SKILL.md]"]
  node_spec_doc["Spec Document<br/>[spec-template.md]"]
  node_spec_patterns["Spec Patterns<br/>[spec-patterns.md]"]
end

subgraph group_build["Build &amp; Learning"]
  node_build_skill["Build Skill<br/>[SKILL.md]"]
  node_checklist["Build Checklist"]
  node_code_tour["Code Tour Guide<br/>[code-tour.md]"]
  node_app["Learner App"]
  node_app_map["App Map"]
end

subgraph group_ship["Shipping"]
  node_ship_skill["Ship Skill<br/>[SKILL.md]"]
  node_submission["Devpost Submission"]
  node_video["Demo Video"]
  node_github["Public GitHub Repo"]
end

node_learner(("Learner"))

node_learner -->|"invokes"| node_start
node_start -->|"records experience"| node_profile
node_start -->|"routes forward"| node_scope
node_scope -->|"fills"| node_scope_doc
node_scope -->|"routes forward"| node_prd
node_prd -->|"fills"| node_prd_doc
node_prd -.->|"uses guidance"| node_prd_guide
node_prd -->|"routes forward"| node_spec
node_spec -->|"fills"| node_spec_doc
node_spec -.->|"uses patterns"| node_spec_patterns
node_spec -->|"routes forward"| node_build_skill
node_build_skill -->|"fills"| node_checklist
node_build_skill -.->|"uses guide"| node_code_tour
node_build_skill -->|"builds"| node_app
node_build_skill -->|"produces"| node_app_map
node_build_skill -->|"routes forward"| node_ship_skill
node_ship_skill -->|"prepares"| node_video
node_ship_skill -->|"publishes"| node_github
node_ship_skill -->|"supports learner writing"| node_submission
node_learner -->|"submits"| node_ship_skill

click node_start "https://github.com/challengepost/learn-ai-basics/blob/main/skills/1-start/SKILL.md"
click node_profile "https://github.com/challengepost/learn-ai-basics/blob/main/skills/1-start/templates/learner-profile-template.md"
click node_scope "https://github.com/challengepost/learn-ai-basics/blob/main/skills/2-scope/SKILL.md"
click node_scope_doc "https://github.com/challengepost/learn-ai-basics/blob/main/skills/2-scope/templates/scope-template.md"
click node_prd "https://github.com/challengepost/learn-ai-basics/blob/main/skills/3-prd/SKILL.md"
click node_prd_doc "https://github.com/challengepost/learn-ai-basics/blob/main/skills/3-prd/templates/prd-template.md"
click node_prd_guide "https://github.com/challengepost/learn-ai-basics/blob/main/skills/3-prd/references/prd-guide.md"
click node_spec "https://github.com/challengepost/learn-ai-basics/blob/main/skills/4-spec/SKILL.md"
click node_spec_doc "https://github.com/challengepost/learn-ai-basics/blob/main/skills/4-spec/templates/spec-template.md"
click node_spec_patterns "https://github.com/challengepost/learn-ai-basics/blob/main/skills/4-spec/references/spec-patterns.md"
click node_build_skill "https://github.com/challengepost/learn-ai-basics/blob/main/skills/5-build/SKILL.md"
click node_checklist "https://github.com/challengepost/learn-ai-basics/blob/main/skills/5-build/templates/checklist-template.md"
click node_code_tour "https://github.com/challengepost/learn-ai-basics/blob/main/skills/5-build/references/code-tour.md"
click node_ship_skill "https://github.com/challengepost/learn-ai-basics/blob/main/skills/6-ship/SKILL.md"

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_start,node_profile,node_scope,node_scope_doc toneBlue
class node_prd,node_prd_doc,node_prd_guide,node_spec,node_spec_doc,node_spec_patterns toneAmber
class node_build_skill,node_checklist,node_code_tour,node_app,node_app_map toneMint
class node_ship_skill,node_submission,node_video,node_github toneRose
class node_learner toneIndigo
```

## Components

### Onboarding & Scope

- [Start Skill](https://github.com/challengepost/learn-ai-basics/blob/main/skills/1-start/SKILL.md): `skills/1-start/SKILL.md`
- [Learner Profile](https://github.com/challengepost/learn-ai-basics/blob/main/skills/1-start/templates/learner-profile-template.md): `skills/1-start/templates/learner-profile-template.md`
- [Scope Skill](https://github.com/challengepost/learn-ai-basics/blob/main/skills/2-scope/SKILL.md): `skills/2-scope/SKILL.md`
- [Scope Document](https://github.com/challengepost/learn-ai-basics/blob/main/skills/2-scope/templates/scope-template.md): `skills/2-scope/templates/scope-template.md`

### Product Planning

- [PRD Skill](https://github.com/challengepost/learn-ai-basics/blob/main/skills/3-prd/SKILL.md): `skills/3-prd/SKILL.md`
- [PRD Document](https://github.com/challengepost/learn-ai-basics/blob/main/skills/3-prd/templates/prd-template.md): `skills/3-prd/templates/prd-template.md`
- [PRD Guide](https://github.com/challengepost/learn-ai-basics/blob/main/skills/3-prd/references/prd-guide.md): `skills/3-prd/references/prd-guide.md`
- [Spec Skill](https://github.com/challengepost/learn-ai-basics/blob/main/skills/4-spec/SKILL.md): `skills/4-spec/SKILL.md`
- [Spec Document](https://github.com/challengepost/learn-ai-basics/blob/main/skills/4-spec/templates/spec-template.md): `skills/4-spec/templates/spec-template.md`
- [Spec Patterns](https://github.com/challengepost/learn-ai-basics/blob/main/skills/4-spec/references/spec-patterns.md): `skills/4-spec/references/spec-patterns.md`

### Build & Learning

- [Build Skill](https://github.com/challengepost/learn-ai-basics/blob/main/skills/5-build/SKILL.md): `skills/5-build/SKILL.md`
- [Build Checklist](https://github.com/challengepost/learn-ai-basics/blob/main/skills/5-build/templates/checklist-template.md): `skills/5-build/templates/checklist-template.md`
- [Code Tour Guide](https://github.com/challengepost/learn-ai-basics/blob/main/skills/5-build/references/code-tour.md): `skills/5-build/references/code-tour.md`
- **Learner App**
- **App Map**

### Shipping

- [Ship Skill](https://github.com/challengepost/learn-ai-basics/blob/main/skills/6-ship/SKILL.md): `skills/6-ship/SKILL.md`
- **Devpost Submission**
- **Demo Video**
- **Public GitHub Repo**

### Other components

- **Learner**

## Connections

- Learner → Start Skill: invokes (evidence: `README.md`)
- Start Skill → Learner Profile: records experience (evidence: `README.md`)
- Start Skill → Scope Skill: routes forward (evidence: `README.md`)
- Scope Skill → Scope Document: fills (evidence: `README.md`)
- Scope Skill → PRD Skill: routes forward (evidence: `README.md`)
- PRD Skill → PRD Document: fills (evidence: `README.md`)
- PRD Skill → PRD Guide: uses guidance
- PRD Skill → Spec Skill: routes forward (evidence: `README.md`)
- Spec Skill → Spec Document: fills (evidence: `README.md`)
- Spec Skill → Spec Patterns: uses patterns
- Spec Skill → Build Skill: routes forward (evidence: `README.md`)
- Build Skill → Build Checklist: fills (evidence: `README.md`)
- Build Skill → Code Tour Guide: uses guide
- Build Skill → Learner App: builds (evidence: `README.md`)
- Build Skill → App Map: produces (evidence: `README.md`)
- Build Skill → Ship Skill: routes forward (evidence: `README.md`)
- Ship Skill → Demo Video: prepares (evidence: `README.md`)
- Ship Skill → Public GitHub Repo: publishes (evidence: `README.md`)
- Ship Skill → Devpost Submission: supports learner writing (evidence: `README.md`)
- Learner → Ship Skill: submits (evidence: `README.md`)
