01
It starts by itself
push to main. Runs in GitHub Actions or Claude Code routine.
- ↻ push to main
push to main
tt-a1i · 87K starsArchify skill
Runs by itself, every time new code is saved.
Your code map is redrawn after every change.
Install the Archify skill and make it a habit: follow https://gethabit.dev/skills/tt-a1i/archify.md
- 1Copy
- 2Paste into Claude Code, Codex or Cursor
- 3It runs by itself
87K starsMIT licenceSource on GitHub ↗
Archify
by tt-a1i · 87K stars
The skill
Draws a clickable map of how your code fits together.
Only when you ask.
Faster start
Your code map is redrawn after every change. New people get up to speed faster.
↻ Runs by itselfevery time new code is saved
How the habit works.
You don't have to.
When does it start? How does it check its work? What does it remember?
One run, step by step.
Then it stops.
Stops after one diagram per run, with at most 2 repair rounds.
- 01
Pick the type
Choose the diagram type from the Type router, such as architecture or dataflow.
- 02
Read references
Read the authoring defaults, the schema and the example, plus repository authoring for code-backed diagrams.
- 03
Write the candidate
Write candidate.json in a new .archify folder with source evidence from the repo.
- 04
Finalize
Run finalize with --repo-root and --quality showcase and keep the candidate unchanged meanwhile.
- 05
Repair
On a non-zero exit, repair the failed gate and rerun finalize with its own --out-dir.
- 06
Report
Link the HTML and note any update notice from the receipt.
What it may do.
Nothing more.
It writes only in its own folder and asks you before anything goes out.
- Writes only in.archify/**, loops/archify-diagram-loop/**
- Talks tono outside service
- Sendsnothing
- Your OKNothing goes out, so it needs no OK.
Is it for you?
Use it when it fits.
Read both lists. If the left one sounds like you, the Archify skill helps.
Use it when
- ✓ New people need to understand the codebase fast
- ✓ You want a diagram that matches the real files
- ✓ You review a design before you build it
Skip it when
- – The project is a single small script
- – You need a hand-drawn whiteboard sketch
Archify skill, answered.
Does a passing run mean it looks good?
It means the automated gates passed. Visual review is a separate, optional step.
Can it read Mermaid?
Yes. It reads Mermaid for meaning and writes fresh Archify JSON.
Will it update Archify itself?
No. It only mentions an update notice and never installs on its own.
How do I install the Archify skill?
Copy the prompt at the top into your agent. It installs the skill from tt-a1i/archify and sets up the habit. Or run npx skills add tt-a1i/archify --skill archify.
Is the Archify skill free?
Yes. It is published under MIT. Habit is free too.
Archify. Now as a habit.
Install the Archify skill and make it a habit: follow https://gethabit.dev/skills/tt-a1i/archify.md
All tt-a1i skills →More docs skills →
Works in
- Claude Code
- Codex
- Cursor
- ChatGPT
- Claude app
Made by tt-a1i, published under MIT. Habit links to the original and never changes it. Is this your skill?