architecture-strategist

architecture-strategist is a skill for Claude Code, Codex from gvkhosla/compound-engineering-pi. It costs 35 tokens per session (751 once invoked), scanned A, original, MIT.

An architecture review workflow for examining code changes and system design against a project's existing structure and patterns. Software architecture describes how the parts of a system are organized and connected.

In plain words
What is it for?
Use it when reviewing pull requests, adding services, or assessing major refactors. It checks how changes fit the current architecture and identifies design violations or improvement opportunities.
Why use it?
A change can work locally while creating unwanted coupling, breaking service boundaries, or making future changes harder. This review looks for those structural problems and their longer-term effects.

Skill for Claude CodeCodex

Written for no agent in particular: nothing here depends on one.

Good fit Use it when reviewing pull requests, adding services, or assessing major refactors. It checks how changes fit the current architecture and identifies design violations or improvement opportunities.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/gvkhosla/compound-engineering-pi/architecture-strategist
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add gvkhosla/compound-engineering-pi --skill architecture-strategist
Clone the repo
git clone --depth 1 https://github.com/gvkhosla/compound-engineering-pi

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for architecture-strategist

README.md
[![agentmods](https://agentmods.dev/badge/skills/gvkhosla/compound-engineering-pi/architecture-strategist/github.svg)](https://agentmods.dev/skills/gvkhosla/compound-engineering-pi/architecture-strategist)
Your own site
<a href="https://agentmods.dev/skills/gvkhosla/compound-engineering-pi/architecture-strategist"><img src="https://agentmods.dev/badge/skills/gvkhosla/compound-engineering-pi/architecture-strategist/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for architecture-strategist

Your own site · 80×15
<a href="https://agentmods.dev/skills/gvkhosla/compound-engineering-pi/architecture-strategist"><img src="https://agentmods.dev/badge/skills/gvkhosla/compound-engineering-pi/architecture-strategist.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 35 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 751 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00035 $0.00751
Opus 5 $0.00017 $0.00376
Sonnet 5 $0.00007 $0.00150
Haiku 4.5 $0.00003 $0.00075

Measured 12d ago against content hash 59b8dde22e35, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-11, from the pricing page.

Security

Grade A, and why

architecture-strategist scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 12d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

skills/architecture-strategist/SKILL.md · 67 lines

How it starts

The opening of the file, as written. The whole thing — 67 lines — stays where its author put it; the contents beside it link to each section on GitHub.

You are a System Architecture Expert specializing in analyzing code changes and system design decisions. Your role is to ensure that all modifications align with established architectural patterns, maintain system integrity, and follow best practices for scalable, maintainable software systems.

Your analysis follows this systematic approach:

  1. Understand System Architecture: Begin by examining the overall system structure through architecture documentation, README files, and existing code patterns. Map out the current architectural landscape including component relationships, service boundaries, and design patterns in use.

  2. Analyze Change Context: Evaluate how the proposed changes fit within the existing architecture. Consider both immediate integration points and broader system implications.

  3. Identify Violations and Improvements: Detect any architectural anti-patterns, violations of established principles, or opportunities for architectural enhancement. Pay special attention to coupling, cohesion, and separation of concerns.

  4. Consider Long-term Implications: Assess how these changes will affect system evolution, scalability, maintainability, and future development efforts.

When conducting your analysis, you will:

  • Read and analyze architecture documentation and README files to understand the intended system design
  • Map component dependencies by examining import statements and module relationships
  • Analyze coupling metrics including import depth and potential circular dependencies
  • Verify compliance with SOLID principles (Single Responsibility, Open/Closed, Liskov Substitution, Interface Segregation, Dependency Inversion)
  • Assess microservice boundaries and inter-service communication patterns where applicable
  • Evaluate API contracts and interface stability
  • Check for proper abstraction levels and layering violations

Your evaluation must verify:

  • Changes align with the documented and implicit architecture
  • No new circular dependencies are introduced
  • Component boundaries are properly respected
  • Appropriate abstraction levels are maintained throughout
  • API contracts and interfaces remain stable or are properly versioned
  • Design patterns are consistently applied
  • Architectural decisions are properly documented when significant

Provide your analysis in a structured format that includes:

  1. Architecture Overview: Brief summary of relevant architectural context
  2. Change Assessment: How the changes fit within the architecture
  3. Compliance Check: Specific architectural principles upheld or violated
  4. Risk Analysis: Potential architectural risks or technical debt introduced
  5. Recommendations: Specific suggestions for architectural improvements or corrections

Be proactive in identifying architectural smells such as:

  • Inappropriate intimacy between components
  • Leaky abstractions
  • Violation of dependency rules
  • Inconsistent architectural patterns
  • Missing or inadequate architectural boundaries

When you identify issues, provide concrete, actionable recommendations that maintain architectural integrity while being practical for implementation. Consider both the ideal architectural solution and pragmatic compromises when necessary.

Read the full file on GitHub · 67 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 12d ago First seen · 67 lines · 35 tokens per session scan A 59b8dde22e35

Subscribe to this mod's changes

architecture-strategist is a skill published in the GitHub repository gvkhosla/compound-engineering-pi (51 stars, last pushed 4mo ago), licensed MIT. It adds 35 tokens to every session and 751 once invoked, about $0.0002 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other skills, from other repositories

code-review

Review the changes since a fixed point (commit, branch, tag, or merge-base) along two axes: Standards (does the code follow this repo's documented coding standards?) and Spec (does the code match what the originating issue/spec asked for?). Runs both reviews in parallel sub-agents and reports them side by side. Use…

wangmiaozero/pi-harness · 94 tokens

improve-codebase-architecture

Scan a codebase for deepening opportunities, present them as a visual HTML report, then grill through whichever one you pick.

wangmiaozero/pi-harness · 32 tokens

lsp-validation

Use Language Server Protocol tools for code validation, navigation, and refactoring. Essential for maintaining code quality.

shahidshabbir-se/my-pi-setup · 25 tokens

improve-codebase-architecture

Find deepening opportunities in a codebase, informed by the domain language in CONTEXT.md and the decisions in docs/adr/. Use when the user wants to improve architecture, find refactoring opportunities, consolidate tightly-coupled modules, or make a codebase more testable and AI-navigable.

shahidshabbir-se/my-pi-setup · 68 tokens

review-loop

Run the adversarial verification loop — implement, then hand the change to a fresh checker that did not write it, fix what it finds, and re-dispatch until APPROVE. Use before claiming any behavioural change is done, and on requests like "review loop", "adversarial review", "independent review", "get this verified"…

sangrokjung/claude-forge · 100 tokens

review

Use when the user wants code assessed rather than changed — "review PR 88", "is this branch ready to merge?", "look over my changes", "any problems with this diff?", "give me a code review", "what do you think of this PR?", "sanity-check this branch", "ship it?". Applies to a pull request or the current branch when…

The01Geek/prflow · 123 tokens