# yanivy9h/ai-shipr architecture

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

- Interactive diagram: https://gitdiagram.com/yanivy9h/ai-shipr
- Repository: https://github.com/yanivy9h/ai-shipr

## Overview

AI-SHIPR is a folder-based product operating system for product managers using Claude Code. A PM starts a context-aware session (for example, `/today`), Claude reviews product state and suggests next actions; agents and workflows can write decisions and learning back into the system. Strategy, hypotheses, initiatives, proof, and relationships are distinct product domains, with AI skills, agents, workflows, and playbooks providing the operating layer. The README documents these capabilities; source inspection here was limited to the Figma sync script, so other runtime links are documented rather than source-verified.

Main entry points: [`A-AI/AI-Skills/Today.md`](https://github.com/yanivy9h/ai-shipr/blob/main/A-AI/AI-Skills/Today.md) (Today Skill), [`S-Strategy`](https://github.com/yanivy9h/ai-shipr/tree/main/S-Strategy) (Strategy), [`A-AI/AI-Workflows`](https://github.com/yanivy9h/ai-shipr/tree/main/A-AI/AI-Workflows) (AI Workflows), [`I-Initiatives`](https://github.com/yanivy9h/ai-shipr/tree/main/I-Initiatives) (Initiatives)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ai["AI Operating Layer"]
  node_today["Today Skill<br/>[Today.md]"]
  node_agents["AI Agents"]
  node_skills["AI Skills"]
  node_workflows["AI Workflows"]
  node_playbooks["AI Playbooks"]
end

subgraph group_strategy["Strategy and Discovery"]
  node_strategy_files["Strategy"]
  node_hypotheses["Hypotheses"]
end

subgraph group_execution["Execution and Proof"]
  node_initiatives["Initiatives"]
  node_proof["Proof and Experiments"]
end

subgraph group_context["Relationships and Knowledge"]
  node_relationships["Relationships"]
  node_learning["Accumulated Learning<br/>[Learning.md]"]
  node_decisions["Decision Log<br/>[Decision-Log.md]"]
end

subgraph group_integrations["External Connections"]
  node_connections["Tool Connections<br/>[Connections.md]"]
  node_figma_sync["Figma Sync<br/>[figma-sync.js]"]
end

node_pm(("Product Manager"))
node_figma{{"Figma"}}

node_pm -->|"starts session"| node_today
node_today -->|"reviews active"| node_initiatives
node_today -->|"flags gaps"| node_hypotheses
node_today -->|"suggests experiments"| node_proof
node_today -->|"uses context"| node_strategy_files
node_agents -->|"writes decisions"| node_decisions
node_workflows -->|"writes patterns"| node_learning
node_skills -.->|"supports product work"| node_strategy_files
node_playbooks -.->|"guides routines"| node_workflows
node_initiatives -->|"links to bets"| node_strategy_files
node_proof -.->|"tests hypotheses"| node_hypotheses
node_relationships -.->|"provides context"| node_today
node_connections -.->|"documents integration"| node_figma_sync
node_figma -->|"provides design data"| node_figma_sync

click node_today "https://github.com/yanivy9h/ai-shipr/blob/main/A-AI/AI-Skills/Today.md"
click node_agents "https://github.com/yanivy9h/ai-shipr/tree/main/A-AI/AI-Agents"
click node_skills "https://github.com/yanivy9h/ai-shipr/tree/main/A-AI/AI-Skills"
click node_workflows "https://github.com/yanivy9h/ai-shipr/tree/main/A-AI/AI-Workflows"
click node_playbooks "https://github.com/yanivy9h/ai-shipr/tree/main/A-AI/AI-Playbooks"
click node_strategy_files "https://github.com/yanivy9h/ai-shipr/tree/main/S-Strategy"
click node_hypotheses "https://github.com/yanivy9h/ai-shipr/tree/main/H-Hypotheses"
click node_initiatives "https://github.com/yanivy9h/ai-shipr/tree/main/I-Initiatives"
click node_proof "https://github.com/yanivy9h/ai-shipr/tree/main/P-Proof"
click node_relationships "https://github.com/yanivy9h/ai-shipr/tree/main/R-Relationships"
click node_learning "https://github.com/yanivy9h/ai-shipr/blob/main/Learning.md"
click node_decisions "https://github.com/yanivy9h/ai-shipr/blob/main/Decision-Log.md"
click node_connections "https://github.com/yanivy9h/ai-shipr/blob/main/Connections.md"
click node_figma_sync "https://github.com/yanivy9h/ai-shipr/blob/main/I-Information/Integrations/Figma/figma-sync.js"

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_today,node_agents,node_skills,node_workflows,node_playbooks toneBlue
class node_strategy_files,node_hypotheses toneAmber
class node_initiatives,node_proof toneMint
class node_relationships,node_learning,node_decisions toneRose
class node_connections,node_figma_sync,node_pm,node_figma toneIndigo
```

## Components

### AI Operating Layer

- [Today Skill](https://github.com/yanivy9h/ai-shipr/blob/main/A-AI/AI-Skills/Today.md): `A-AI/AI-Skills/Today.md`
- [AI Agents](https://github.com/yanivy9h/ai-shipr/tree/main/A-AI/AI-Agents): `A-AI/AI-Agents`
- [AI Skills](https://github.com/yanivy9h/ai-shipr/tree/main/A-AI/AI-Skills): `A-AI/AI-Skills`
- [AI Workflows](https://github.com/yanivy9h/ai-shipr/tree/main/A-AI/AI-Workflows): `A-AI/AI-Workflows`
- [AI Playbooks](https://github.com/yanivy9h/ai-shipr/tree/main/A-AI/AI-Playbooks): `A-AI/AI-Playbooks`

### Strategy and Discovery

- [Strategy](https://github.com/yanivy9h/ai-shipr/tree/main/S-Strategy): `S-Strategy`
- [Hypotheses](https://github.com/yanivy9h/ai-shipr/tree/main/H-Hypotheses): `H-Hypotheses`

### Execution and Proof

- [Initiatives](https://github.com/yanivy9h/ai-shipr/tree/main/I-Initiatives): `I-Initiatives`
- [Proof and Experiments](https://github.com/yanivy9h/ai-shipr/tree/main/P-Proof): `P-Proof`

### Relationships and Knowledge

- [Relationships](https://github.com/yanivy9h/ai-shipr/tree/main/R-Relationships): `R-Relationships`
- [Accumulated Learning](https://github.com/yanivy9h/ai-shipr/blob/main/Learning.md): `Learning.md`
- [Decision Log](https://github.com/yanivy9h/ai-shipr/blob/main/Decision-Log.md): `Decision-Log.md`

### External Connections

- [Tool Connections](https://github.com/yanivy9h/ai-shipr/blob/main/Connections.md): `Connections.md`
- [Figma Sync](https://github.com/yanivy9h/ai-shipr/blob/main/I-Information/Integrations/Figma/figma-sync.js): `I-Information/Integrations/Figma/figma-sync.js`

### Other components

- **Product Manager**
- **Figma**

## Connections

- Product Manager → Today Skill: starts session (evidence: `README.md`)
- Today Skill → Initiatives: reviews active (evidence: `README.md`)
- Today Skill → Hypotheses: flags gaps (evidence: `README.md`)
- Today Skill → Proof and Experiments: suggests experiments (evidence: `README.md`)
- Today Skill → Strategy: uses context (evidence: `README.md`)
- AI Agents → Decision Log: writes decisions (evidence: `README.md`)
- AI Workflows → Accumulated Learning: writes patterns (evidence: `README.md`)
- AI Skills → Strategy: supports product work
- AI Playbooks → AI Workflows: guides routines
- Initiatives → Strategy: links to bets (evidence: `README.md`)
- Proof and Experiments → Hypotheses: tests hypotheses
- Relationships → Today Skill: provides context
- Tool Connections → Figma Sync: documents integration
- Figma → Figma Sync: provides design data (evidence: `I-Information/Integrations/Figma/figma-sync.js`)