# abdulazeem-m0uneer/senior-developer-arsenal architecture

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

- Interactive diagram: https://gitdiagram.com/abdulazeem-m0uneer/senior-developer-arsenal
- Repository: https://github.com/abdulazeem-m0uneer/senior-developer-arsenal

## Overview

Senior Developer Arsenal is a cross-agent AI engineering toolkit: an engineer works through a supported coding agent, which applies shared rules and task-specific skills, and can delegate to specialist subagents. For Claude Code, hooks add session and tool-call safeguards, including destructive-action checks and lesson-based prevention. The README documents the broader agent support and learning ledgers; the excerpts show selected hook internals but not the full plugin wiring or all skill and subagent implementations, so those relationships are documented rather than inferred from names.

Main entry points: [`hooks/guard.py`](https://github.com/abdulazeem-m0uneer/senior-developer-arsenal/blob/master/hooks/guard.py) (Tool guard), [`hooks/guard_lessons.py`](https://github.com/abdulazeem-m0uneer/senior-developer-arsenal/blob/master/hooks/guard_lessons.py) (Lesson checks), [`hooks/agent_hook.py`](https://github.com/abdulazeem-m0uneer/senior-developer-arsenal/blob/master/hooks/agent_hook.py) (Hook entry), [`hooks/guard_destructive.py`](https://github.com/abdulazeem-m0uneer/senior-developer-arsenal/blob/master/hooks/guard_destructive.py) (Destructive checks)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_guidance["Engineering guidance"]
  node_rules["Engineering rules<br/>[rules]"]
  node_skills["Task skills<br/>[skills]"]
end

subgraph group_agent["Agent integration"]
  node_coding_agent["Coding agent"]
  node_subagents["Specialist subagents<br/>[subagents]"]
  node_mcp_config["MCP definitions<br/>[servers.json]"]
end

subgraph group_safety["Session safeguards"]
  node_hook_entry["Hook entry<br/>[agent_hook.py]"]
  node_guard["Tool guard<br/>[guard.py]"]
  node_destructive["Destructive checks"]
  node_calendar["Calendar checks<br/>[guard_calendar.py]"]
  node_scope["Edit scope<br/>[guard_scope.py]"]
  node_model_guard["Model tier checks<br/>[guard_models.py]"]
  node_session_state["Session state<br/>[session_core.py]"]
end

subgraph group_learning["Mistake learning"]
  node_lesson_guard["Lesson checks<br/>[guard_lessons.py]"]
  node_lesson_ledger[("Lesson ledger<br/>[ledger_store.py]")]
  node_lesson_workflows["Lesson workflows<br/>[scripts]"]
end

node_engineer(("Engineer"))

node_engineer -->|"uses"| node_coding_agent
node_coding_agent -->|"applies"| node_rules
node_coding_agent -->|"uses"| node_skills
node_coding_agent -->|"delegates to"| node_subagents
node_coding_agent -.->|"configures"| node_mcp_config
node_coding_agent -.->|"runs hooks"| node_hook_entry
node_hook_entry -.->|"dispatches"| node_guard
node_guard -->|"checks commands"| node_destructive
node_guard -->|"checks outbound text"| node_calendar
node_guard -->|"checks writes"| node_scope
node_guard -->|"checks model"| node_model_guard
node_guard -->|"checks lessons"| node_lesson_guard
node_guard -.->|"tracks session"| node_session_state
node_lesson_guard -->|"reads lessons"| node_lesson_ledger
node_lesson_guard -->|"uses calendar rules"| node_calendar
node_lesson_guard -->|"uses command parsing"| node_destructive
node_lesson_workflows -.->|"maintains"| node_lesson_ledger

click node_rules "https://github.com/abdulazeem-m0uneer/senior-developer-arsenal/tree/master/.agents/rules"
click node_skills "https://github.com/abdulazeem-m0uneer/senior-developer-arsenal/tree/master/.agents/skills"
click node_subagents "https://github.com/abdulazeem-m0uneer/senior-developer-arsenal/tree/master/.agents/subagents"
click node_mcp_config "https://github.com/abdulazeem-m0uneer/senior-developer-arsenal/blob/master/.agents/mcp/servers.json"
click node_hook_entry "https://github.com/abdulazeem-m0uneer/senior-developer-arsenal/blob/master/hooks/agent_hook.py"
click node_guard "https://github.com/abdulazeem-m0uneer/senior-developer-arsenal/blob/master/hooks/guard.py"
click node_destructive "https://github.com/abdulazeem-m0uneer/senior-developer-arsenal/blob/master/hooks/guard_destructive.py"
click node_calendar "https://github.com/abdulazeem-m0uneer/senior-developer-arsenal/blob/master/hooks/guard_calendar.py"
click node_scope "https://github.com/abdulazeem-m0uneer/senior-developer-arsenal/blob/master/hooks/guard_scope.py"
click node_model_guard "https://github.com/abdulazeem-m0uneer/senior-developer-arsenal/blob/master/hooks/guard_models.py"
click node_lesson_guard "https://github.com/abdulazeem-m0uneer/senior-developer-arsenal/blob/master/hooks/guard_lessons.py"
click node_session_state "https://github.com/abdulazeem-m0uneer/senior-developer-arsenal/blob/master/hooks/session_core.py"
click node_lesson_ledger "https://github.com/abdulazeem-m0uneer/senior-developer-arsenal/blob/master/.agents/skills/lessons-learned/scripts/ledger_store.py"
click node_lesson_workflows "https://github.com/abdulazeem-m0uneer/senior-developer-arsenal/tree/master/.agents/skills/lessons-learned/scripts"

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_rules,node_skills toneBlue
class node_coding_agent,node_subagents,node_mcp_config toneAmber
class node_hook_entry,node_guard,node_destructive,node_calendar,node_scope,node_model_guard,node_session_state toneMint
class node_lesson_guard,node_lesson_ledger,node_lesson_workflows toneRose
class node_engineer toneIndigo
```

## Components

### Engineering guidance

- [Engineering rules](https://github.com/abdulazeem-m0uneer/senior-developer-arsenal/tree/master/.agents/rules): `.agents/rules`
- [Task skills](https://github.com/abdulazeem-m0uneer/senior-developer-arsenal/tree/master/.agents/skills): `.agents/skills`

### Agent integration

- **Coding agent**
- [Specialist subagents](https://github.com/abdulazeem-m0uneer/senior-developer-arsenal/tree/master/.agents/subagents): `.agents/subagents`
- [MCP definitions](https://github.com/abdulazeem-m0uneer/senior-developer-arsenal/blob/master/.agents/mcp/servers.json): `.agents/mcp/servers.json`

### Session safeguards

- [Hook entry](https://github.com/abdulazeem-m0uneer/senior-developer-arsenal/blob/master/hooks/agent_hook.py): `hooks/agent_hook.py`
- [Tool guard](https://github.com/abdulazeem-m0uneer/senior-developer-arsenal/blob/master/hooks/guard.py): `hooks/guard.py`
- [Destructive checks](https://github.com/abdulazeem-m0uneer/senior-developer-arsenal/blob/master/hooks/guard_destructive.py): `hooks/guard_destructive.py`
- [Calendar checks](https://github.com/abdulazeem-m0uneer/senior-developer-arsenal/blob/master/hooks/guard_calendar.py): `hooks/guard_calendar.py`
- [Edit scope](https://github.com/abdulazeem-m0uneer/senior-developer-arsenal/blob/master/hooks/guard_scope.py): `hooks/guard_scope.py`
- [Model tier checks](https://github.com/abdulazeem-m0uneer/senior-developer-arsenal/blob/master/hooks/guard_models.py): `hooks/guard_models.py`
- [Session state](https://github.com/abdulazeem-m0uneer/senior-developer-arsenal/blob/master/hooks/session_core.py): `hooks/session_core.py`

### Mistake learning

- [Lesson checks](https://github.com/abdulazeem-m0uneer/senior-developer-arsenal/blob/master/hooks/guard_lessons.py): `hooks/guard_lessons.py`
- [Lesson ledger](https://github.com/abdulazeem-m0uneer/senior-developer-arsenal/blob/master/.agents/skills/lessons-learned/scripts/ledger_store.py): `.agents/skills/lessons-learned/scripts/ledger_store.py`
- [Lesson workflows](https://github.com/abdulazeem-m0uneer/senior-developer-arsenal/tree/master/.agents/skills/lessons-learned/scripts): `.agents/skills/lessons-learned/scripts`

### Other components

- **Engineer**

## Connections

- Engineer → Coding agent: uses (evidence: `README.md`)
- Coding agent → Engineering rules: applies (evidence: `README.md`)
- Coding agent → Task skills: uses (evidence: `README.md`)
- Coding agent → Specialist subagents: delegates to (evidence: `README.md`)
- Coding agent → MCP definitions: configures
- Coding agent → Hook entry: runs hooks
- Hook entry → Tool guard: dispatches
- Tool guard → Destructive checks: checks commands (evidence: `hooks/guard.py`)
- Tool guard → Calendar checks: checks outbound text (evidence: `hooks/guard.py`)
- Tool guard → Edit scope: checks writes (evidence: `hooks/guard.py`)
- Tool guard → Model tier checks: checks model (evidence: `hooks/guard.py`)
- Tool guard → Lesson checks: checks lessons (evidence: `hooks/guard.py`)
- Tool guard → Session state: tracks session
- Lesson checks → Lesson ledger: reads lessons (evidence: `hooks/guard_lessons.py`)
- Lesson checks → Calendar checks: uses calendar rules (evidence: `hooks/guard_lessons.py`)
- Lesson checks → Destructive checks: uses command parsing (evidence: `hooks/guard_lessons.py`)
- Lesson workflows → Lesson ledger: maintains
