Open-source architecture maps for real codebases

Understand a codebase you didn't write

Tecture turns your repo into a navigable architecture model: plain JSON and Markdown files written by your own coding agent, committed with the code, and reviewed in PRs so they can stay current.

Your code never leaves your environment — your own agent does the reading.

01 Install the skill
terminal — bash
$ npx @tecture/skill@latest
02 Run it in your coding agent
coding agent
/ architecture-docs
03 View it

the skill writes the model · view it in VS Code or your browser

Watch the demo

See the architecture, then drill into the code

Watch Tecture map the Redis repository from system context down to containers, components, and files. Start broad, follow the relationships, then inspect the parts that matter.

Video thumbnail: Demo: Documenting Redis repo architecture
Demo: Documenting Redis repo architecture
video · watch the demo
REC
demo · documenting redis repo architecture
How it works

Architecture as files in your repo

Tecture does not ask you to maintain a separate wiki. Your coding agent reads the source and writes a file-based architecture model next to it — the structure is JSON, the explanations are Markdown. Changes show up in pull requests, where the team that owns the repo can review, correct, and improve them like any other code change.

Your agent authors

Coding agent skill

Your agent reads the source and writes the architecture as JSON + Markdown, committed next to the code.

$ npx @tecture/skill@latest
File-based model · in your repo
manifest.json diagrams/system-context.json descriptions/api-server.md
You navigate

VS Code or browser

Opens those same files as an interactive, multi-level diagram you drill through — in the VS Code extension, or run npx @tecture/core to view it in any browser.

VS Code · or your browser
For AI agents

Give your coding agent the architecture it keeps missing

A coding agent can read source, but source alone rarely explains architectural intent: which boundaries matter, which modules own which jobs, and which shortcuts will cause pain later. Because Tecture stores the architecture model as plain files in the repo, your agent can read that model as context while it works — something better than scattered comments, stale notes, or unwritten tribal knowledge.

The model is agent-authored and human-verified in review. It is not magic — it is structured context your team can inspect, correct, and keep close to the code.

The problem

Most architecture knowledge is trapped in people's heads

Architecture docs were always useful. They just rotted, because keeping them updated cost too much. Tecture makes the upkeep cheap enough to do inside the normal development loop.

FIG.01

Onboarding takes weeks

New engineers reverse-engineer the architecture by reading code and asking around, because there's no accurate map of the system.

FIG.02

Refactors become guesswork

Without an up-to-date view of components and dependencies, every change risks breaking something nobody knew was connected.

FIG.03

Docs rot the moment you merge

Hand-drawn diagrams and wiki pages are stale by the next pull request. Nobody trusts them, so nobody updates them.

Quick tour

A multi-level map of the repo

A diagram you can move through instead of a static page you read front to back — start at the system context, drill into containers and components, and follow them down to the files that implement them. Real screenshots of Tecture mapping the Redis repo.

What you get

Built for developers who don't want another docs system

FIG.01

Agent-authored docs

Your coding agent reads the source and writes the architecture model as JSON and Markdown — the first pass costs you nothing.

FIG.02

Repo-native files

The model lives beside the code, so it can be reviewed, versioned, and updated through normal development workflows.

FIG.03

Interactive architecture viewer

Explore components, dependencies, and descriptions in VS Code or any browser.

FIG.04

Reviewable changes

Architecture updates go through pull requests, reviewed and corrected by the team that owns the repo.

FIG.05

No code upload required

Your code stays in your environment — your own agent does the reading, and Tecture adds no new data paths.

FIG.06

Open source

MIT licensed and ready to inspect, from the skill to the viewer.

Honest limits

Review still matters

Tecture gives your team a fast, structured first pass at the architecture. It does not replace engineering judgment. Your agent can miss intent, misunderstand boundaries, or describe something too broadly — that is why the model lives in the repo: so the people who own the system can review it, correct it, and improve it over time.

Read the docs →
Get started

Map the repo before your next refactor

Start with one codebase. Generate the model, review it with the team, then open the map and see what you have been carrying around in your head.

MIT Open source
npm @tecture/core
PR-native Reviewed like code
terminal — bash
$ npx @tecture/skill@latest
Teams

Running this across many repos?

The open-source tool documents individual repositories. If you are trying to map architecture across teams, services, and repositories, talk to us about Tecture Enterprise.

Enquire about Enterprise