# mohammad-adnan-shahid/pos architecture

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

- Interactive diagram: https://gitdiagram.com/mohammad-adnan-shahid/pos
- Repository: https://github.com/mohammad-adnan-shahid/pos

## Overview

Spec Kit Plus is a command-line project bootstrapper and a collection of prompt templates for AI-assisted, spec-driven development. Its principal workflow is selecting a project/agent setup, fetching and unpacking a matching template, then using commands to move from requirements through planning and implementation. The CLI excerpts support the GitHub release/download path; the command-template lifecycle is apparent from the tree, but its runtime dispatch is not shown, so no dispatch edges are asserted.

Main entry points: [`spec-kit-plus/src/specify_cli/__init__.py`](https://github.com/mohammad-adnan-shahid/pos/blob/update-specs-saas-pos/spec-kit-plus/src/specify_cli/__init__.py) (Specify CLI), [`spec-kit-plus/templates/commands/specify.md`](https://github.com/mohammad-adnan-shahid/pos/blob/update-specs-saas-pos/spec-kit-plus/templates/commands/specify.md) (Specify Requirements), [`spec-kit-plus/templates/commands/plan.md`](https://github.com/mohammad-adnan-shahid/pos/blob/update-specs-saas-pos/spec-kit-plus/templates/commands/plan.md) (Plan Work), [`spec-kit-plus/templates/commands/tasks.md`](https://github.com/mohammad-adnan-shahid/pos/blob/update-specs-saas-pos/spec-kit-plus/templates/commands/tasks.md) (Break Into Tasks)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_bootstrap["Project Bootstrap"]
  node_cli["Specify CLI<br/>[__init__.py]"]
  node_archive["Template Archive"]
  node_project["Bootstrapped Project"]
  node_scripts["Setup Scripts"]
end

subgraph group_workflow["SDD Workflow"]
  node_commands["Command Prompts"]
  node_specify["Specify Requirements<br/>[specify.md]"]
  node_clarify["Clarify Requirements<br/>[clarify.md]"]
  node_plan["Plan Work<br/>[plan.md]"]
  node_tasks["Break Into Tasks<br/>[tasks.md]"]
  node_implement["Implement<br/>[implement.md]"]
  node_analyze["Analyze<br/>[analyze.md]"]
  node_phr["Record History<br/>[phr.md]"]
  node_adr["Record Decisions<br/>[adr.md]"]
end

subgraph group_guidance["Project Guidance"]
  node_constitution["Project Constitution<br/>[constitution.md]"]
  node_constitutionplus["Extended Constitution"]
  node_agenttemplate["Agent File Template"]
  node_spec_template["Specification Template<br/>[spec-template.md]"]
  node_plan_template["Plan Template<br/>[plan-template.md]"]
  node_task_template["Task Template<br/>[tasks-template.md]"]
end

node_developer(("Developer"))
node_github["GitHub Releases"]

node_developer -->|"runs"| node_cli
node_cli -->|"requests release"| node_github
node_github -->|"returns asset metadata"| node_cli
node_cli -->|"downloads and unpacks"| node_archive
node_cli -->|"creates project"| node_project
node_cli -->|"uses setup helpers"| node_scripts
node_developer -->|"starts workflow"| node_specify
node_specify -->|"refines requirements"| node_clarify
node_clarify -->|"informs planning"| node_plan
node_plan -->|"defines tasks"| node_tasks
node_tasks -->|"guides execution"| node_implement
node_implement -->|"supports review"| node_analyze
node_developer -->|"records progress"| node_phr
node_developer -->|"records decisions"| node_adr
node_constitution -.->|"guides"| node_specify
node_constitutionplus -.->|"guides"| node_specify
node_agenttemplate -.->|"provides guidance"| node_project
node_spec_template -.->|"structures output"| node_specify
node_plan_template -.->|"structures output"| node_plan
node_task_template -.->|"structures output"| node_tasks

click node_cli "https://github.com/mohammad-adnan-shahid/pos/blob/update-specs-saas-pos/spec-kit-plus/src/specify_cli/__init__.py"
click node_scripts "https://github.com/mohammad-adnan-shahid/pos/tree/update-specs-saas-pos/spec-kit-plus/scripts"
click node_commands "https://github.com/mohammad-adnan-shahid/pos/tree/update-specs-saas-pos/spec-kit-plus/templates/commands"
click node_specify "https://github.com/mohammad-adnan-shahid/pos/blob/update-specs-saas-pos/spec-kit-plus/templates/commands/specify.md"
click node_clarify "https://github.com/mohammad-adnan-shahid/pos/blob/update-specs-saas-pos/spec-kit-plus/templates/commands/clarify.md"
click node_plan "https://github.com/mohammad-adnan-shahid/pos/blob/update-specs-saas-pos/spec-kit-plus/templates/commands/plan.md"
click node_tasks "https://github.com/mohammad-adnan-shahid/pos/blob/update-specs-saas-pos/spec-kit-plus/templates/commands/tasks.md"
click node_implement "https://github.com/mohammad-adnan-shahid/pos/blob/update-specs-saas-pos/spec-kit-plus/templates/commands/implement.md"
click node_analyze "https://github.com/mohammad-adnan-shahid/pos/blob/update-specs-saas-pos/spec-kit-plus/templates/commands/analyze.md"
click node_phr "https://github.com/mohammad-adnan-shahid/pos/blob/update-specs-saas-pos/spec-kit-plus/templates/commands/phr.md"
click node_adr "https://github.com/mohammad-adnan-shahid/pos/blob/update-specs-saas-pos/spec-kit-plus/templates/commands/adr.md"
click node_constitution "https://github.com/mohammad-adnan-shahid/pos/blob/update-specs-saas-pos/spec-kit-plus/memory/constitution.md"
click node_constitutionplus "https://github.com/mohammad-adnan-shahid/pos/blob/update-specs-saas-pos/spec-kit-plus/memory/constitutionplus.md"
click node_agenttemplate "https://github.com/mohammad-adnan-shahid/pos/blob/update-specs-saas-pos/spec-kit-plus/templates/agent-file-template.md"
click node_spec_template "https://github.com/mohammad-adnan-shahid/pos/blob/update-specs-saas-pos/spec-kit-plus/templates/spec-template.md"
click node_plan_template "https://github.com/mohammad-adnan-shahid/pos/blob/update-specs-saas-pos/spec-kit-plus/templates/plan-template.md"
click node_task_template "https://github.com/mohammad-adnan-shahid/pos/blob/update-specs-saas-pos/spec-kit-plus/templates/tasks-template.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_cli,node_archive,node_project,node_scripts toneBlue
class node_commands,node_specify,node_clarify,node_plan,node_tasks,node_implement,node_analyze,node_phr,node_adr toneAmber
class node_constitution,node_constitutionplus,node_agenttemplate,node_spec_template,node_plan_template,node_task_template toneMint
class node_developer,node_github toneIndigo
```

## Components

### Project Bootstrap

- [Specify CLI](https://github.com/mohammad-adnan-shahid/pos/blob/update-specs-saas-pos/spec-kit-plus/src/specify_cli/__init__.py): `spec-kit-plus/src/specify_cli/__init__.py`
- **Template Archive**
- **Bootstrapped Project**
- [Setup Scripts](https://github.com/mohammad-adnan-shahid/pos/tree/update-specs-saas-pos/spec-kit-plus/scripts): `spec-kit-plus/scripts`

### SDD Workflow

- [Command Prompts](https://github.com/mohammad-adnan-shahid/pos/tree/update-specs-saas-pos/spec-kit-plus/templates/commands): `spec-kit-plus/templates/commands`
- [Specify Requirements](https://github.com/mohammad-adnan-shahid/pos/blob/update-specs-saas-pos/spec-kit-plus/templates/commands/specify.md): `spec-kit-plus/templates/commands/specify.md`
- [Clarify Requirements](https://github.com/mohammad-adnan-shahid/pos/blob/update-specs-saas-pos/spec-kit-plus/templates/commands/clarify.md): `spec-kit-plus/templates/commands/clarify.md`
- [Plan Work](https://github.com/mohammad-adnan-shahid/pos/blob/update-specs-saas-pos/spec-kit-plus/templates/commands/plan.md): `spec-kit-plus/templates/commands/plan.md`
- [Break Into Tasks](https://github.com/mohammad-adnan-shahid/pos/blob/update-specs-saas-pos/spec-kit-plus/templates/commands/tasks.md): `spec-kit-plus/templates/commands/tasks.md`
- [Implement](https://github.com/mohammad-adnan-shahid/pos/blob/update-specs-saas-pos/spec-kit-plus/templates/commands/implement.md): `spec-kit-plus/templates/commands/implement.md`
- [Analyze](https://github.com/mohammad-adnan-shahid/pos/blob/update-specs-saas-pos/spec-kit-plus/templates/commands/analyze.md): `spec-kit-plus/templates/commands/analyze.md`
- [Record History](https://github.com/mohammad-adnan-shahid/pos/blob/update-specs-saas-pos/spec-kit-plus/templates/commands/phr.md): `spec-kit-plus/templates/commands/phr.md`
- [Record Decisions](https://github.com/mohammad-adnan-shahid/pos/blob/update-specs-saas-pos/spec-kit-plus/templates/commands/adr.md): `spec-kit-plus/templates/commands/adr.md`

### Project Guidance

- [Project Constitution](https://github.com/mohammad-adnan-shahid/pos/blob/update-specs-saas-pos/spec-kit-plus/memory/constitution.md): `spec-kit-plus/memory/constitution.md`
- [Extended Constitution](https://github.com/mohammad-adnan-shahid/pos/blob/update-specs-saas-pos/spec-kit-plus/memory/constitutionplus.md): `spec-kit-plus/memory/constitutionplus.md`
- [Agent File Template](https://github.com/mohammad-adnan-shahid/pos/blob/update-specs-saas-pos/spec-kit-plus/templates/agent-file-template.md): `spec-kit-plus/templates/agent-file-template.md`
- [Specification Template](https://github.com/mohammad-adnan-shahid/pos/blob/update-specs-saas-pos/spec-kit-plus/templates/spec-template.md): `spec-kit-plus/templates/spec-template.md`
- [Plan Template](https://github.com/mohammad-adnan-shahid/pos/blob/update-specs-saas-pos/spec-kit-plus/templates/plan-template.md): `spec-kit-plus/templates/plan-template.md`
- [Task Template](https://github.com/mohammad-adnan-shahid/pos/blob/update-specs-saas-pos/spec-kit-plus/templates/tasks-template.md): `spec-kit-plus/templates/tasks-template.md`

### Other components

- **Developer**
- **GitHub Releases**

## Connections

- Developer → Specify CLI: runs
- Specify CLI → GitHub Releases: requests release
- GitHub Releases → Specify CLI: returns asset metadata
- Specify CLI → Template Archive: downloads and unpacks
- Specify CLI → Bootstrapped Project: creates project
- Specify CLI → Setup Scripts: uses setup helpers
- Developer → Specify Requirements: starts workflow
- Specify Requirements → Clarify Requirements: refines requirements
- Clarify Requirements → Plan Work: informs planning
- Plan Work → Break Into Tasks: defines tasks
- Break Into Tasks → Implement: guides execution
- Implement → Analyze: supports review
- Developer → Record History: records progress
- Developer → Record Decisions: records decisions
- Project Constitution → Specify Requirements: guides
- Extended Constitution → Specify Requirements: guides
- Agent File Template → Bootstrapped Project: provides guidance
- Specification Template → Specify Requirements: structures output
- Plan Template → Plan Work: structures output
- Task Template → Break Into Tasks: structures output