# Architecture Deepening Review

> Review a codebase for architecture deepening opportunities: shallow modules, weak seams, scattered domain logic, low testability, high coupling, and AI-navigability friction. Use when the user asks for architecture improvement, refactoring opportunities, modularity, test seams, or maintainability review.

- **Type:** Skill
- **Install:** `agentstack add skill-markoblogo-abvx-agent-skills-architecture-deepening-review`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [markoblogo](https://agentstack.voostack.com/s/markoblogo)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [markoblogo](https://github.com/markoblogo)
- **Source:** https://github.com/markoblogo/abvx-agent-skills/tree/main/skills/architecture-deepening-review
- **Website:** https://abvx.xyz/work/abvx-agent-skills

## Install

```sh
agentstack add skill-markoblogo-abvx-agent-skills-architecture-deepening-review
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Architecture Deepening Review

Find refactors that increase leverage and locality. A deeper module hides meaningful behavior behind a smaller, clearer interface.

## Vocabulary

- Module: code with an interface and implementation.
- Interface: everything callers must know, including types, invariants, errors, ordering, config, and side effects.
- Seam: place where behavior can vary without editing callers.
- Adapter: concrete implementation behind a seam.
- Depth: useful behavior hidden behind a small interface.
- Locality: related behavior and knowledge concentrated in one place.

## Review Workflow

1. Read the nearest README, architecture docs, domain glossary, ADRs, and tests when present.
2. Map the user-facing or domain workflow before judging structure.
3. Look for friction:
   - understanding one concept requires bouncing across many files;
   - modules pass through data with little leverage;
   - tests exist only around extracted fragments, not real behavior;
   - domain rules are duplicated across callers;
   - adapters exist in theory but only one implementation exists;
   - hidden coupling crosses package or component boundaries;
   - naming does not match domain language.
4. Apply the deletion test: if removing a module only moves complexity into callers, it may be shallow. If removing it spreads domain complexity everywhere, it is probably earning its keep.
5. Rank candidates by payoff, risk, and confidence.

## Candidate Format

For each candidate:

- files/modules;
- current friction;
- proposed deeper module or seam;
- expected locality and leverage gain;
- testability improvement;
- risks and migration path;
- recommendation strength: strong, worth exploring, or speculative.

Do not implement broad refactors without user confirmation. For implementation, carve one vertical slice and preserve behavior with tests.

## Optional HTML Report

When the user asks for a shareable architecture review, executive-readable report, or visual artifact, do not inline a long prose dump. Route the findings into `html-diagram-artifact` or `html-brief-artifact` after the candidate list is stable. The HTML artifact should stay evidence-backed: files/modules, friction, proposed seam, benefit, risk, and first slice.

## Final Report

End with the top recommendation, the smallest first step, and what evidence would change the recommendation.

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [markoblogo](https://github.com/markoblogo)
- **Source:** [markoblogo/abvx-agent-skills](https://github.com/markoblogo/abvx-agent-skills)
- **License:** MIT
- **Homepage:** https://abvx.xyz/work/abvx-agent-skills

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-markoblogo-abvx-agent-skills-architecture-deepening-review
- Seller: https://agentstack.voostack.com/s/markoblogo
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.