# i-am-manware/manware-s-ai-learning-toolkit architecture

> Architecture diagram of the GitHub repository i-am-manware/manware-s-ai-learning-toolkit, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-29). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/i-am-manware/manware-s-ai-learning-toolkit
- Repository: https://github.com/i-am-manware/manware-s-ai-learning-toolkit

## Overview

Manware’s AI Learning Toolkit is a prompt-based customization for GitHub Copilot Chat, not an application. The main workflow is a learner invoking a slash-command prompt, thinking through its questions, implementing and testing independently, then explaining or reviewing; `/learn` helps choose a workflow. Reusable skills shape responses, while `/retrieve` can read optional learning logs. The README documents these relationships and capabilities; source excerpts were unavailable, so the graph omits undocumented internal wiring.

Main entry points: [`.github/prompts/retrieve.prompt.md`](https://github.com/i-am-manware/manware-s-ai-learning-toolkit/blob/copilot/.github/prompts/retrieve.prompt.md) (Retrieval practice), [`.github/instructions/learning-files.instructions.md`](https://github.com/i-am-manware/manware-s-ai-learning-toolkit/blob/copilot/.github/instructions/learning-files.instructions.md) (Log instructions), [`.github/prompts/learn.prompt.md`](https://github.com/i-am-manware/manware-s-ai-learning-toolkit/blob/copilot/.github/prompts/learn.prompt.md) (Choose workflow), [`learning/concepts.md`](https://github.com/i-am-manware/manware-s-ai-learning-toolkit/blob/copilot/learning/concepts.md) (Concept log)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_workflows["Learning workflows"]
  node_learn["Choose workflow<br/>[learn.prompt.md]"]
  node_hint["Incremental hints<br/>[hint.prompt.md]"]
  node_debug["Diagnose bugs<br/>[debug.prompt.md]"]
  node_autopsy["Bug post-mortem<br/>[autopsy.prompt.md]"]
  node_read["Read code<br/>[read.prompt.md]"]
  node_review["Code review"]
  node_test["Design tests<br/>[test.prompt.md]"]
  node_explore["Explore designs<br/>[explore.prompt.md]"]
  node_arch["Architecture interview<br/>[arch.prompt.md]"]
  node_explain["Teach-back<br/>[explain.prompt.md]"]
  node_retrieve["Retrieval practice<br/>[retrieve.prompt.md]"]
  node_api["Learn an API<br/>[api.prompt.md]"]
end

subgraph group_behaviors["Reusable behaviors"]
  node_debugging["Debugging skill<br/>[SKILL.md]"]
  node_examination["Examination skill<br/>[SKILL.md]"]
  node_code_review["Review skill<br/>[SKILL.md]"]
  node_retrieval_skill["Retrieval skill<br/>[SKILL.md]"]
end

subgraph group_configuration["Copilot guidance"]
  node_global_guidance["Learning philosophy"]
  node_log_rules["Log instructions"]
end

subgraph group_records["Learning records"]
  node_concepts["Concept log<br/>[concepts.md]"]
  node_mistakes["Mistake log<br/>[mistakes.md]"]
  node_questions["Question log<br/>[questions.md]"]
  node_review_log["Review log<br/>[review.md]"]
end

node_learner(("Learner"))
node_copilot(("Copilot Chat"))

node_learner -->|"uses chat"| node_copilot
node_learner -->|"invokes command"| node_learn
node_learner -->|"invokes command"| node_hint
node_learner -->|"invokes command"| node_debug
node_learner -->|"invokes command"| node_autopsy
node_learner -->|"invokes command"| node_read
node_learner -->|"invokes command"| node_review
node_learner -->|"invokes command"| node_test
node_learner -->|"invokes command"| node_explore
node_learner -->|"invokes command"| node_arch
node_learner -->|"invokes command"| node_explain
node_learner -->|"invokes command"| node_retrieve
node_learner -->|"invokes command"| node_api
node_learn -->|"guides workflow choice"| node_copilot
node_global_guidance -->|"guides responses"| node_copilot
node_debugging -->|"shapes behavior"| node_copilot
node_examination -->|"shapes behavior"| node_copilot
node_code_review -->|"shapes behavior"| node_copilot
node_retrieval_skill -->|"shapes behavior"| node_copilot
node_retrieve -.->|"reads optionally"| node_concepts
node_retrieve -.->|"reads optionally"| node_mistakes
node_retrieve -.->|"reads optionally"| node_questions
node_retrieve -.->|"reads optionally"| node_review_log
node_log_rules -->|"guides logging"| node_concepts
node_log_rules -->|"guides logging"| node_mistakes
node_log_rules -->|"guides logging"| node_questions
node_log_rules -->|"guides logging"| node_review_log

click node_learn "https://github.com/i-am-manware/manware-s-ai-learning-toolkit/blob/copilot/.github/prompts/learn.prompt.md"
click node_hint "https://github.com/i-am-manware/manware-s-ai-learning-toolkit/blob/copilot/.github/prompts/hint.prompt.md"
click node_debug "https://github.com/i-am-manware/manware-s-ai-learning-toolkit/blob/copilot/.github/prompts/debug.prompt.md"
click node_autopsy "https://github.com/i-am-manware/manware-s-ai-learning-toolkit/blob/copilot/.github/prompts/autopsy.prompt.md"
click node_read "https://github.com/i-am-manware/manware-s-ai-learning-toolkit/blob/copilot/.github/prompts/read.prompt.md"
click node_review "https://github.com/i-am-manware/manware-s-ai-learning-toolkit/blob/copilot/.github/prompts/code-review.prompt.md"
click node_test "https://github.com/i-am-manware/manware-s-ai-learning-toolkit/blob/copilot/.github/prompts/test.prompt.md"
click node_explore "https://github.com/i-am-manware/manware-s-ai-learning-toolkit/blob/copilot/.github/prompts/explore.prompt.md"
click node_arch "https://github.com/i-am-manware/manware-s-ai-learning-toolkit/blob/copilot/.github/prompts/arch.prompt.md"
click node_explain "https://github.com/i-am-manware/manware-s-ai-learning-toolkit/blob/copilot/.github/prompts/explain.prompt.md"
click node_retrieve "https://github.com/i-am-manware/manware-s-ai-learning-toolkit/blob/copilot/.github/prompts/retrieve.prompt.md"
click node_api "https://github.com/i-am-manware/manware-s-ai-learning-toolkit/blob/copilot/.github/prompts/api.prompt.md"
click node_debugging "https://github.com/i-am-manware/manware-s-ai-learning-toolkit/blob/copilot/.github/skills/debugging/SKILL.md"
click node_examination "https://github.com/i-am-manware/manware-s-ai-learning-toolkit/blob/copilot/.github/skills/examination/SKILL.md"
click node_code_review "https://github.com/i-am-manware/manware-s-ai-learning-toolkit/blob/copilot/.github/skills/code-review/SKILL.md"
click node_retrieval_skill "https://github.com/i-am-manware/manware-s-ai-learning-toolkit/blob/copilot/.github/skills/retrieval/SKILL.md"
click node_global_guidance "https://github.com/i-am-manware/manware-s-ai-learning-toolkit/blob/copilot/.github/copilot-instructions.md"
click node_log_rules "https://github.com/i-am-manware/manware-s-ai-learning-toolkit/blob/copilot/.github/instructions/learning-files.instructions.md"
click node_concepts "https://github.com/i-am-manware/manware-s-ai-learning-toolkit/blob/copilot/learning/concepts.md"
click node_mistakes "https://github.com/i-am-manware/manware-s-ai-learning-toolkit/blob/copilot/learning/mistakes.md"
click node_questions "https://github.com/i-am-manware/manware-s-ai-learning-toolkit/blob/copilot/learning/questions.md"
click node_review_log "https://github.com/i-am-manware/manware-s-ai-learning-toolkit/blob/copilot/learning/review.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_learn,node_hint,node_debug,node_autopsy,node_read,node_review,node_test,node_explore,node_arch,node_explain,node_retrieve,node_api toneBlue
class node_debugging,node_examination,node_code_review,node_retrieval_skill toneAmber
class node_global_guidance,node_log_rules toneMint
class node_concepts,node_mistakes,node_questions,node_review_log toneRose
class node_learner,node_copilot toneIndigo
```

## Components

### Learning workflows

- [Choose workflow](https://github.com/i-am-manware/manware-s-ai-learning-toolkit/blob/copilot/.github/prompts/learn.prompt.md): `.github/prompts/learn.prompt.md`
- [Incremental hints](https://github.com/i-am-manware/manware-s-ai-learning-toolkit/blob/copilot/.github/prompts/hint.prompt.md): `.github/prompts/hint.prompt.md`
- [Diagnose bugs](https://github.com/i-am-manware/manware-s-ai-learning-toolkit/blob/copilot/.github/prompts/debug.prompt.md): `.github/prompts/debug.prompt.md`
- [Bug post-mortem](https://github.com/i-am-manware/manware-s-ai-learning-toolkit/blob/copilot/.github/prompts/autopsy.prompt.md): `.github/prompts/autopsy.prompt.md`
- [Read code](https://github.com/i-am-manware/manware-s-ai-learning-toolkit/blob/copilot/.github/prompts/read.prompt.md): `.github/prompts/read.prompt.md`
- [Code review](https://github.com/i-am-manware/manware-s-ai-learning-toolkit/blob/copilot/.github/prompts/code-review.prompt.md): `.github/prompts/code-review.prompt.md`
- [Design tests](https://github.com/i-am-manware/manware-s-ai-learning-toolkit/blob/copilot/.github/prompts/test.prompt.md): `.github/prompts/test.prompt.md`
- [Explore designs](https://github.com/i-am-manware/manware-s-ai-learning-toolkit/blob/copilot/.github/prompts/explore.prompt.md): `.github/prompts/explore.prompt.md`
- [Architecture interview](https://github.com/i-am-manware/manware-s-ai-learning-toolkit/blob/copilot/.github/prompts/arch.prompt.md): `.github/prompts/arch.prompt.md`
- [Teach-back](https://github.com/i-am-manware/manware-s-ai-learning-toolkit/blob/copilot/.github/prompts/explain.prompt.md): `.github/prompts/explain.prompt.md`
- [Retrieval practice](https://github.com/i-am-manware/manware-s-ai-learning-toolkit/blob/copilot/.github/prompts/retrieve.prompt.md): `.github/prompts/retrieve.prompt.md`
- [Learn an API](https://github.com/i-am-manware/manware-s-ai-learning-toolkit/blob/copilot/.github/prompts/api.prompt.md): `.github/prompts/api.prompt.md`

### Reusable behaviors

- [Debugging skill](https://github.com/i-am-manware/manware-s-ai-learning-toolkit/blob/copilot/.github/skills/debugging/SKILL.md): `.github/skills/debugging/SKILL.md`
- [Examination skill](https://github.com/i-am-manware/manware-s-ai-learning-toolkit/blob/copilot/.github/skills/examination/SKILL.md): `.github/skills/examination/SKILL.md`
- [Review skill](https://github.com/i-am-manware/manware-s-ai-learning-toolkit/blob/copilot/.github/skills/code-review/SKILL.md): `.github/skills/code-review/SKILL.md`
- [Retrieval skill](https://github.com/i-am-manware/manware-s-ai-learning-toolkit/blob/copilot/.github/skills/retrieval/SKILL.md): `.github/skills/retrieval/SKILL.md`

### Copilot guidance

- [Learning philosophy](https://github.com/i-am-manware/manware-s-ai-learning-toolkit/blob/copilot/.github/copilot-instructions.md): `.github/copilot-instructions.md`
- [Log instructions](https://github.com/i-am-manware/manware-s-ai-learning-toolkit/blob/copilot/.github/instructions/learning-files.instructions.md): `.github/instructions/learning-files.instructions.md`

### Learning records

- [Concept log](https://github.com/i-am-manware/manware-s-ai-learning-toolkit/blob/copilot/learning/concepts.md): `learning/concepts.md`
- [Mistake log](https://github.com/i-am-manware/manware-s-ai-learning-toolkit/blob/copilot/learning/mistakes.md): `learning/mistakes.md`
- [Question log](https://github.com/i-am-manware/manware-s-ai-learning-toolkit/blob/copilot/learning/questions.md): `learning/questions.md`
- [Review log](https://github.com/i-am-manware/manware-s-ai-learning-toolkit/blob/copilot/learning/review.md): `learning/review.md`

### Other components

- **Learner**
- **Copilot Chat**

## Connections

- Learner → Copilot Chat: uses chat
- Learner → Choose workflow: invokes command
- Learner → Incremental hints: invokes command
- Learner → Diagnose bugs: invokes command
- Learner → Bug post-mortem: invokes command
- Learner → Read code: invokes command
- Learner → Code review: invokes command
- Learner → Design tests: invokes command
- Learner → Explore designs: invokes command
- Learner → Architecture interview: invokes command
- Learner → Teach-back: invokes command
- Learner → Retrieval practice: invokes command
- Learner → Learn an API: invokes command
- Choose workflow → Copilot Chat: guides workflow choice
- Learning philosophy → Copilot Chat: guides responses
- Debugging skill → Copilot Chat: shapes behavior
- Examination skill → Copilot Chat: shapes behavior
- Review skill → Copilot Chat: shapes behavior
- Retrieval skill → Copilot Chat: shapes behavior
- Retrieval practice → Concept log: reads optionally
- Retrieval practice → Mistake log: reads optionally
- Retrieval practice → Question log: reads optionally
- Retrieval practice → Review log: reads optionally
- Log instructions → Concept log: guides logging
- Log instructions → Mistake log: guides logging
- Log instructions → Question log: guides logging
- Log instructions → Review log: guides logging
