Agent skill

Ab Update Architecture

by ayoubben18 in ayoubben18/ab-method

Refresh architecture and domain documentation after impactful changes.

MITAuto-check passed

Install Ab Update Architecture

skills CLI
$ npx skills add ayoubben18/ab-method --skill ab-update-architecture -a claude-code

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

GitHub CLI
$ gh skill install ayoubben18/ab-method ab-update-architecture --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/ayoubben18/ab-method.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/ab-update-architecture .claude/skills/ab-update-architecture && 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
ab-update-architecture
GitHub stars
192
Token cost
~351 tokens
SKILL.md length
167 words
Files
1
Skills in repo
26
Repo updated
First seen
Licence
MIT

At a glance

Refresh architecture and domain documentation after impactful changes.

  • Works in 2 steps: The project root (the current working… → Only if the project has no such file (AB…
  • Code has drifted from the documented architecture
  • Calls npx

What it does

Ab Update Architecture is an agent skill from ayoubben18/ab-method. Refresh architecture and domain documentation after impactful changes. Use when code has drifted from the documented architecture.

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

The repository describes itself as: A workflow system for Claude Code and Codex. It grills a problem into a domain-grounded plan, then either drives it through test-driven missions you review one at a time, or… The licence is MIT.

When your agent uses it

  • Code has drifted from the documented architecture

Example prompts

  • “/ab-update-architecture”

Requirements

  • Node.js

Workflow steps

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

  1. The project root (the current working directory) first. If /.ab-method/... exists, use it. A project's own .ab-method/structure/index.yaml…
  2. Only if the project has no such file (AB Method installed as a plugin rather than with npx ab-method), read the bundled copy…

What it can do on your machine

Read from SKILL.md and the folder at commit 85946e3. 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

    Shell commands in SKILL.md call:

    • npx

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

  • Network

    No URLs in SKILL.md. Its commands use npx, which can reach the network depending on how they are called.

    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

Ab Update Architecture loads about 351 tokens when it runs. Until then it costs about 38 tokens; SKILL.md has 167 words of instructions outside code blocks.

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

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

The full file from ayoubben18/ab-method at commit 85946e3, republished under its MIT licence (© ayoubben18). 167 words, ~351 tokens.

Download SKILL.mdSave it as .claude/skills/ab-update-architecture/SKILL.md (or your agent's skills folder).
name
ab-update-architecture
description
Refresh architecture and domain documentation after impactful changes. Use when code has drifted from the documented architecture.

This skill runs the AB Method update-architecture workflow.

Follow the workflow defined in .ab-method/core/update-architecture.md exactly — it contains the full process, output format, and rules.

Before doing anything, check .ab-method/structure/index.yaml. It defines where this workflow reads from and writes to. Paths are user-configurable; never hardcode them.

Locating .ab-method/. Every .ab-method/... path — here and inside the workflow files — is resolved in this order:

  1. The project root (the current working directory) first. If <project>/.ab-method/... exists, use it. A project's own .ab-method/structure/index.yaml is how it customises its paths, so it always wins — check for it even when the bundled copy is right there.
  2. Only if the project has no such file (AB Method installed as a plugin rather than with npx ab-method), read the bundled copy: ../../../.ab-method/ relative to this SKILL.md.

The bundled copy is read-only reference material. Every path the index or a workflow names (docs/..., CONTEXT.md, UBIQUITOUS_LANGUAGE.md, ...) is relative to the project root — never to the folder the bundled files live in. Never write inside that folder.

© ayoubben18, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .agents/skills/ab-update-architecture of ayoubben18/ab-method.

Open the folder on GitHubat commit 85946e3

Compare with similar skills

Ab Update Architecture 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.

Ab Update Architecture compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Ab Update Architecture this skillayoubben18/ab-method192—~351Automated safety check: PassMIT
Index Refreshpaperclipai/paperclip99k—~994Automated safety check: PassMIT
Meta Refreshthedaviddias/Front-End-Checklist74k—~434Automated safety check: PassMIT
Sitemap Domainthedaviddias/Front-End-Checklist74k—~531Automated safety check: PassMIT
Domain Driven Designdavila7/claude-code-templates33k5 repos~623Automated safety check: PassMIT
Domain Modeling and Glossarywindmill-labs/windmill18k—~622Automated safety check: PassCustom licence

Similar skills

  • Index Refresh

    paperclipai/paperclip

    A skill your agent uses when an LLM Wiki operation issue requests an index refresh.

    99k GitHub stars~994 tokensUpdated today
    Knowledge ManagementAuto-check passed
  • Meta Refresh

    thedaviddias/Front-End-Checklist

    A skill your agent uses when reviewing rendered HTML, interactive components, or design-system patterns related to Avoid meta refresh redirects.

    74k GitHub stars~434 tokensUpdated 3 days ago
    Frontend & DesignAuto-check passed
  • Sitemap Domain

    thedaviddias/Front-End-Checklist

    A skill your agent uses when applies to sites that have recently migrated from HTTP to HTTPS, changed domain name, or have www/non-www redirect configurations.

    74k GitHub stars~531 tokensUpdated 3 days ago
    Marketing & SEOAuto-check passed
  • Domain Driven Design

    davila7/claude-code-templates

    Plan and route Domain-Driven Design work from strategic modeling to tactical implementation and evented architecture patterns.

    33k GitHub starsUsed in 5 repos~623 tokens
    DevelopmentAuto-check passed
  • Domain Modeling and Glossary

    windmill-labs/windmill

    Actively challenges vague or conflicting terminology as you design, and keeps a living domain glossary file up to date in real time.

    18k GitHub stars~622 tokensUpdated today
    DevelopmentAuto-check passed
  • Codebase Domain Flow Extractor

    Egonex-AI/Understand-Anything

    Extracts business domains, flows and process steps from a codebase and produces an interactive horizontal flow graph, reusing an existing knowledge graph when one exists.

    86k GitHub stars~2.4k tokensUpdated yesterday
    Knowledge ManagementAuto-check passed

More from ayoubben18/ab-method

All 26 skills in this repo
  • Codebase Design

    ayoubben18/ab-method

    Shared vocabulary and principles for designing deep modules — small interfaces, clean seams, testable through the interface.

    192 GitHub stars~1.7k tokensUpdated 9 days ago
    Auto-check passed
  • Grill With Docs

    ayoubben18/ab-method

    Grilling session that challenges your plan against the existing domain model, sharpens terminology, and updates documentation (CONTEXT.md, ADRs) inline as decisions crystallise.

    192 GitHub stars~2.1k tokensUpdated 9 days ago
    Auto-check passed
  • Change Map

    ayoubben18/ab-method

    Draw a task's blast radius twice. An agent skill from ayoubben18/ab-method.

    192 GitHub stars~2.9k tokensUpdated 9 days ago
    Auto-check passed
  • Handoff

    ayoubben18/ab-method

    Compact the current conversation (or a side-topic that surfaced mid-grill) into a handoff document another agent can pick up.

    192 GitHub stars~696 tokensUpdated 9 days ago
    Auto-check passed
  • Improve Codebase Architecture

    ayoubben18/ab-method

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

    192 GitHub stars~1.9k tokensUpdated 9 days ago
    Auto-check passed
  • Reconcile Roadmap

    ayoubben18/ab-method

    Cross-plan coherence critic for a whole roadmap. An agent skill from ayoubben18/ab-method.

    192 GitHub stars~2.8k tokensUpdated 9 days ago
    Auto-check passed

Questions about Ab Update Architecture

What does Ab Update Architecture do?

Refresh architecture and domain documentation after impactful changes. Ab Update Architecture is an agent skill from ayoubben18/ab-method. Refresh architecture and domain documentation after impactful changes.

When should I use Ab Update Architecture?

Ab Update Architecture fits situations like: code has drifted from the documented architecture.

How do I install Ab Update Architecture in Claude Code?

Run `npx skills add ayoubben18/ab-method --skill ab-update-architecture -a claude-code`. Or copy the skill folder (.agents/skills/ab-update-architecture in ayoubben18/ab-method) into .claude/skills/ab-update-architecture in your project. Claude Code loads it when a task matches its description.

How do I install Ab Update Architecture in Codex?

Run `npx skills add ayoubben18/ab-method --skill ab-update-architecture -a codex`. Or copy the skill folder (.agents/skills/ab-update-architecture in ayoubben18/ab-method) into .agents/skills/ab-update-architecture in your project. Codex loads it when a task matches its description.

Can I use Ab Update Architecture 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 ayoubben18/ab-method --skill ab-update-architecture -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/ab-update-architecture, .gemini/skills/ab-update-architecture, .github/skills/ab-update-architecture and .opencode/skills/ab-update-architecture in your project.

What does Ab Update Architecture need to run?

Going by SKILL.md and its folder, Ab Update Architecture needs the command-line tools its instructions call (npx). Our summary lists: Node.js.

Does Ab Update Architecture access the network?

SKILL.md contains no URLs. Its commands use npx, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Ab Update Architecture 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 Ab Update Architecture use?

Ab Update Architecture is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Ab Update Architecture use?

About 351 tokens (SKILL.md is roughly 1.4k 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 Ab Update Architecture?

Skills that share tags, products or a category with Ab Update Architecture: Index Refresh (paperclipai/paperclip, 99k stars), Meta Refresh (thedaviddias/Front-End-Checklist, 74k stars), Sitemap Domain (thedaviddias/Front-End-Checklist, 74k stars) and Domain Driven Design (davila7/claude-code-templates, 33k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Ab Update Architecture?

ayoubben18 (a GitHub user) maintains it in ayoubben18/ab-method, which has 192 GitHub stars. The repository holds 26 skills in this directory. The repository was last updated on October 1, 2026.

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