Agent skill

Architecture Plan Review

by sesori-ai in sesori-ai/sesori_apps_monorepo

Reviews an architecture-bearing development plan against strict Sesori architectural rules.

Custom licenceAuto-check passedAgent Workflows

Install Architecture Plan Review

skills CLI
$ npx skills add sesori-ai/sesori_apps_monorepo --skill architecture-plan-review -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install sesori-ai/sesori_apps_monorepo architecture-plan-review --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/sesori-ai/sesori_apps_monorepo.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/architecture-plan-review .claude/skills/architecture-plan-review && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
architecture-plan-review
GitHub stars
126
Token cost
~15k tokens
SKILL.md length
4,759 words
Files
1
Skills in repo
14
Repo updated
First seen
Licence
Custom licence

At a glance

Reviews an architecture-bearing development plan against strict Sesori architectural rules.

  • Works in 2 steps: A clear goal — what the feature/change… → A concrete implementation plan — which…
  • Tasks that involve Subagents
  • SKILL.md covers Strictness Discipline, User Final Authority, Legacy Code and Pre-Review Gate, plus 6 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Architecture Plan Review is an agent skill from sesori-ai/sesori_apps_monorepo. Reviews an architecture-bearing development plan against strict Sesori architectural rules. Must be invoked as a sub-agent: the main agent should ask a sub-agent to perform the review using this skill, rather than loading the skill directly in the main agent context. Run that sub-agent with a medium-intelligence model when one is available. The caller fixes valid findings directly without re-reviewing those fixes. A plan may be reviewed again after a too-vague rejection or considerable changes caused by new…

Its SKILL.md is about 15k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Agent Workflows, covering Subagents and Codebase knowledge for agents. The repository describes itself as: Sesori iOS/Android app and the Sesori Bridge CLI — drive Claude, Codex, OpenCode, Cursor, Pi, OMP, Hermes coding sessions from your phone.

When your agent uses it

  • Tasks that involve Subagents
  • Tasks that involve Codebase knowledge for agents

Example prompts

  • “Use the architecture-plan-review skill to review an architecture-bearing development plan against strict Sesori architectural rules”
  • “/architecture-plan-review”

Workflow steps

2 steps, taken from the first numbered list in SKILL.md.

  1. A clear goal — what the feature/change achieves
  2. A concrete implementation plan — which files/classes/layers are touched, what goes where, how data flows

What it can do on your machine

Read from SKILL.md and the folder at commit 55c7d4c. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Architecture Plan Review loads about 15k tokens when it runs. Until then it costs about 141 tokens; SKILL.md has 4,759 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~141
When it runs · the whole SKILL.md, loaded when a task matches
~15k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

Its licence (Custom licence) doesn't allow us to republish the file, so here is its outline and opening line. It has 4,759 words (~14,856 tokens).

“You are the strict architectural plan reviewer for the Sesori Apps Monorepo. You evaluate development plans — goal plus concrete implementation steps — against the architectural rules defined in this document, BEFORE any code is written.”

— opening of SKILL.md by sesori-ai, Custom licence
name
architecture-plan-review

Read the full SKILL.md on GitHub

Files

Just SKILL.md in .agents/skills/architecture-plan-review of sesori-ai/sesori_apps_monorepo.

Open the folder on GitHubat commit 55c7d4c

Compare with similar skills

Architecture Plan Review next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Architecture Plan Review compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Architecture Plan Review this skillsesori-ai/sesori_apps_monorepo126—~15kAutomated safety check: PassCustom licence
Init Deep AGENTS.md Generatorcode-yeongyu/oh-my-openagent70k—~3.5kAutomated safety check: PassCustom licence
Dotagents Standardgetknit/knit133—~4.1kAutomated safety check: PassMIT
O2 Review Loopopenobserve/openobserve22k—~3.7kAutomated safety check: PassAGPL-3.0
ccc Semantic Code Searchcocoindex-io/cocoindex-code2.8k—~938Automated safety check: PassApache-2.0
Repomix Codebase Packeryamadashy/repomix29k—~1.3kAutomated safety check: NotesMIT

Similar skills

  • Init Deep AGENTS.md Generator

    code-yeongyu/oh-my-openagent

    Generates a tree of AGENTS.md files for a repository, one at the root and more in complex subdirectories, so agents learn its structure and conventions.

    70k GitHub stars~3.5k tokensUpdated today
    Agent WorkflowsAuto-check passed
  • Dotagents Standard

    getknit/knit

    Set up, author, and navigate the dotagents standard — a slim AGENTS.md "router" at the repository root plus a hidden .agents/ directory (rules, context, memory, personas, skills, specs, logs, tasks)…

    133 GitHub stars~4.1k tokensUpdated yesterday
    Agent WorkflowsAuto-check passed
  • O2 Review Loop

    openobserve/openobserve

    Splits a change into planner, coder and independent reviewer roles: you confirm a spec, a subagent implements it, and a separate reviewer checks each round's local WIP commit.

    22k GitHub stars~3.7k tokensUpdated yesterday
    Agent WorkflowsAuto-check passed
  • ccc Semantic Code Search

    cocoindex-io/cocoindex-code

    Semantic code search and index management with the ccc CLI: the agent initializes, indexes and queries the project by concept, filtering by language or path.

    2.8k GitHub stars~938 tokensUpdated 4 days ago
    Agent WorkflowsAuto-check passed
  • Repomix Codebase Packer

    yamadashy/repomix

    Packs a local directory or remote GitHub repository into one AI-friendly file with Repomix, then searches it to explore structure, find patterns and count tokens.

    29k GitHub stars~1.3k tokensUpdated today
    Agent WorkflowsAuto-check: notes
  • Codebase Handbook Builder

    Ruhan-Wang/Harness_Handbook

    Generates, refreshes, validates and uses a compact handbook that maps where a change touches in a repository, using the active Codex session and no external LLM API.

    334 GitHub stars~2.2k tokensUpdated 2 mo ago
    Agent WorkflowsAuto-check passed

More from sesori-ai/sesori_apps_monorepo

All 14 skills in this repo
  • macOS Desktop QA

    sesori-ai/sesori_apps_monorepo

    Build, launch, inspect, and exercise the Sesori macOS desktop app as a real QA target.

    126 GitHub stars~2.3k tokensUpdated 2 days ago
    Auto-check passed
  • PR Inline Comments

    sesori-ai/sesori_apps_monorepo

    Fetch inline (code) review comments on a GitHub pull request, grouped into threads, with optional filtering by datetime.

    126 GitHub stars~2.3k tokensUpdated 2 days ago
    Auto-check passed
  • Monitor PR

    sesori-ai/sesori_apps_monorepo

    Monitor GitHub PRs with the prmonitor tool and handle incoming "[PR Monitor]" reports.

    126 GitHub stars~1.2k tokensUpdated 2 days ago
    Auto-check passed
  • Release Notes

    sesori-ai/sesori_apps_monorepo

    Generate a polished, user-facing release-notes markdown file for a requested release (e.g.

    126 GitHub stars~3.6k tokensUpdated 2 days ago
    Auto-check passed
  • Add Analytics

    sesori-ai/sesori_apps_monorepo

    Design or add Sesori product analytics. An agent skill from sesori-ai/sesori_apps_monorepo.

    126 GitHub stars~1.8k tokensUpdated 2 days ago
    Auto-check passed
  • Release

    sesori-ai/sesori_apps_monorepo

    Automates the synchronized Sesori App + Bridge release workflow — bumps versions together and creates a PR

    126 GitHub stars~783 tokensUpdated 2 days ago
    Auto-check passed

Questions about Architecture Plan Review

What does Architecture Plan Review do?

Reviews an architecture-bearing development plan against strict Sesori architectural rules. Architecture Plan Review is an agent skill from sesori-ai/sesori_apps_monorepo. Reviews an architecture-bearing development plan against strict Sesori architectural rules.

When should I use Architecture Plan Review?

Architecture Plan Review fits situations like: tasks that involve Subagents; tasks that involve Codebase knowledge for agents.

How do I install Architecture Plan Review in Claude Code?

Run `npx skills add sesori-ai/sesori_apps_monorepo --skill architecture-plan-review -a claude-code`. Or copy the skill folder (.agents/skills/architecture-plan-review in sesori-ai/sesori_apps_monorepo) into .claude/skills/architecture-plan-review in your project. Claude Code loads it when a task matches its description.

How do I install Architecture Plan Review in Codex?

Run `npx skills add sesori-ai/sesori_apps_monorepo --skill architecture-plan-review -a codex`. Or copy the skill folder (.agents/skills/architecture-plan-review in sesori-ai/sesori_apps_monorepo) into .agents/skills/architecture-plan-review in your project. Codex loads it when a task matches its description.

Can I use Architecture Plan Review in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add sesori-ai/sesori_apps_monorepo --skill architecture-plan-review -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/architecture-plan-review, .gemini/skills/architecture-plan-review, .github/skills/architecture-plan-review and .opencode/skills/architecture-plan-review in your project.

What does Architecture Plan Review need to run?

SKILL.md names no scripts, command-line tools or credentials: Architecture Plan Review is instructions for the agent only.

Does Architecture Plan Review access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Architecture Plan Review safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Architecture Plan Review use?

Architecture Plan Review has a licence file (the repository's licence) that doesn't match a standard licence. Read it on GitHub before reusing the skill.

How many tokens does Architecture Plan Review use?

About 15k tokens (SKILL.md is roughly 59k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Architecture Plan Review?

Skills that share tags, products or a category with Architecture Plan Review: Init Deep AGENTS.md Generator (code-yeongyu/oh-my-openagent, 70k stars), Dotagents Standard (getknit/knit, 133 stars), O2 Review Loop (openobserve/openobserve, 22k stars) and ccc Semantic Code Search (cocoindex-io/cocoindex-code, 2.8k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Architecture Plan Review?

sesori-ai (a GitHub organization) maintains it in sesori-ai/sesori_apps_monorepo, which has 126 GitHub stars. The repository holds 14 skills in this directory. The repository was last updated on October 8, 2026.

Source: sesori-ai/sesori_apps_monorepo on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.