plan-architecture

plan-architecture is a skill for Claude Code, Codex from easyinplay/harnessed. It costs 131 tokens per session (1,376 once invoked), scanned A, original, Apache-2.0.

A one-step review workflow for complex software architecture, meaning designs involving several modules, new core abstractions, scaling concerns, or migration risk.

In plain words
What is it for?
Use it before cross-module designs, new frameworks or data models, performance-critical work, or migrations with significant risk.
Why use it?
It adds a planning checkpoint before changes that could create broad technical or maintenance problems.

Skill for Claude CodeCodex

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.

agentmods
npx agentmods add skills/easyinplay/harnessed/architecture
Any agent
npx skills add easyinplay/harnessed --skill architecture
Clone the repo
git clone --depth 1 https://github.com/easyinplay/harnessed

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 plan-architecture

README.md
[![agentmods](https://agentmods.dev/badge/skills/easyinplay/harnessed/architecture.svg)](https://agentmods.dev/skills/easyinplay/harnessed/architecture)
Your own site
<a href="https://agentmods.dev/skills/easyinplay/harnessed/architecture"><img src="https://agentmods.dev/badge/skills/easyinplay/harnessed/architecture.svg" alt="Measured on agentmods" height="20"></a>
Per session 131 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,376 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
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.00131 $0.01376
Opus 5 $0.00066 $0.00688
Sonnet 5 $0.00026 $0.00275
Haiku 4.5 $0.00013 $0.00138

Measured 5d ago against content hash 8354f72a67f3, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-05, from the pricing page.

Security

Grade A, and why

plan-architecture 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 5d 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.

workflows/plan/architecture/SKILL.md · 86 lines

How it starts

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

plan-architecture workflow (v3)

Overview

1-phase sub-workflow mapping CLAUDE.md "⚠️ 复杂架构前 — plan-eng-review" onto harnessed runtime (Phase v3.0-3.4 W0.4 — D-04 Stage ② Plan 二层 + D-12 gstack 治理关卡 + Pattern A sub-workflow ship)。

phase id upstream model capability gate
1 01-plan-eng-review gstack opus {{ capabilities.plan-eng-review.cmd }} gate: phase.is_complex_architecture == true (literal expr)

Capability refs

Sister workflows/capabilities.yaml entries:

  • plan-eng-review — Bucket 7 gstack 33 optional (impl: gstack, cmd: /plan-eng-review)
    • Pattern A E.2 LOCK: no gstack- prefix per CLAUDE.md gstack skill routing convention

Gate ref

Inline literal expr phase.is_complex_architecture == true — sister capability fires_when clause verbatim。W2.2 backfill 可加 judgments/phase-gate.yaml trigger is-complex-architecture 重构 ref。

Invocation

  • Slash command: /plan-architecture <name> (after harnessed setup)

Routing rules

触发条件 (sister CLAUDE.md "⚠️ 复杂架构前"):

  • 涉及多模块跨界设计 (≥3 模块协同)
  • 新引入核心抽象 (新 framework / 新数据模型 / 新协议)
  • 性能 / scaling 关键路径
  • 引入显著技术债 / migration 风险

How to invoke

!harnessed checkpoint intent plan-architecture

The banner above (when present) means this invocation is REGISTERED with the engine (an intent marker) — not yet compliant: the steps below (prompt → spawn → checkpoint complete) resolve it, and a per-turn <workflow-intent> reminder persists until they run.

The numbered sequence below is the state machine — execute it with Bash. Do NOT improvise an equivalent flow from the Overview above: freelancing bypasses the engine (no ledger, no evidence guard). harnessed gives you the spawn-ready prompt; YOU spawn the subagent with a CC-native Task / Agent tool (keeps the session responsive + lets clarification round-trips reach the user).

Do NOT pipe to harnessed run plan-architecture — that is the CI/headless path (in-process SDK spawn that blocks the session inside Claude Code).

Read the full file on GitHub · 86 lines

Files

What ships with it

2 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

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. 5d ago First seen · 86 lines · 131 tokens per session scan A 8354f72a67f3

Subscribe to this mod's changes

plan-architecture is a skill published in the GitHub repository easyinplay/harnessed (2 stars, last pushed 9d ago), licensed Apache-2.0. It adds 131 tokens to every session and 1,376 once invoked, about $0.0007 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-31.

Related

Other skills, from other repositories

octowiz-doctowiz

The Octowiz doctor — diagnose, monitor, and fix the full octowiz + AELLI integration. Use whenever octowiz or AELLI isn't behaving correctly, a hook isn't firing, an advisory isn't returning, or you want a real-time activity feed. Also guides first-time setup, configuration from scratch, and upgrading from older…

raelli/octowiz · 138 tokens

setup

Setup orchestrator for the Octowiz Bridge. Re-runs the live environment check, builds a gap list, and runs only the phases needed: plugins, memory, repo, verify. Invoked automatically by octowiz:octowiz when hard gaps are detected.

raelli/octowiz · 57 tokens

octowiz

Octowiz AI coding workflow coordinator. Reads IntegraHub memory doctrine at runtime, detects where you are in the development lifecycle, and routes to the right skill combination from superpowers + mattpocock-skills. Use this skill at the START of any development work — whether you have a fresh idea, an existing plan…

raelli/octowiz · 139 tokens

forge

Run a Planner→Dev→Test→Learn workflow for feature development with automatic bug-fix loops and state checkpointing.

zjio26/forge · 25 tokens

meta-tags-optimizer

Optimize title tags, meta descriptions, Open Graph, and Twitter cards for maximum click-through rate. Generates multiple A/B test variations with character counting and SERP preview. Use when asked to "optimize title tag", "write meta description", "improve CTR", "Open Graph tags", "fix my meta tags", "social media…

nowork-studio/notfair-plugin · 91 tokens

google-ads-audit

Google Ads account audit and business context setup. Run this first — it gathers business information, analyzes account health, and saves context that all other ads skills reuse. Trigger on "audit my ads", "ads audit", "set up my ads", "onboard", "account overview", "how's my account", "ads health check", "what should…

nowork-studio/notfair-plugin · 114 tokens