Astory

TELL YOUR ENGINEERING STORY

See the system change, not just the code.

Astory turns source code and pull requests into architectural change intelligence: see your system, understand what changed, and check whether the change satisfies your intended architecture.

Explore architecture, PR diffs, and Arc →

You will sign in with GitHub before Astory reads the repository.

Beta language support: JavaScript/TypeScript, Python, and Java. Astory recognizes common Fastify, Flask/FastAPI, Spring, and AWS SDK patterns; dynamic framework configuration is not inferred.

CURRENT CHAPTER

Understand the system you have now.

Start with a live scan of one repository. The force graph turns applications, components, endpoints, and cloud systems into a readable chapter of your codebase.

Scan a repository now →
● ● ●Current architecturemain
AppAPIJobsDBSNSApplicationpaymentsDynamoDBSNS topic

Click a node or edge to expand its source path.

● ● ●PR #42 · payment events+3 / −1 changes
AppAPIJobsDBSNSS3ApplicationpaymentsDynamoDBSNS topicadded

Green adds, red removes, and amber marks changed dependencies.

EDITS

Make architectural change visible.

Compare commits or a pull request to see which services, dependencies, APIs, and resources were added, removed, or modified—not just which files moved around.

Compare a change →

Arc

Compare architectural intent with the code.

An Arc describes the architecture you intend to build and the requirements for getting there. Astory compares it with your repository and pull request, so you can see what is implemented, what has diverged, and what still needs evidence.

Review Arc results →

Learn how to write an Arc →

● ● ●Arc · Async Order Processingv2 · 2 requirements satisfied
Astory architecture graph with the Async Order Processing Arc overlay and two satisfied requirements

Compare intended architecture with observed code and inspect each requirement’s implementation state.

REREAD

Keep a continuous view of change.

Signed GitHub pull-request webhooks scan changes as they arrive. Open a prepared Catch up view with the summary and graph waiting for you—without manual architecture documentation.

Set up webhook scanning →
● ● ●Catch up · this week3 changes
+ 2 componentsPublish payment eventsApplication → events → SNS
~ 1 dependencyWrite paymentsPayments → DynamoDB
− 1 endpointLegacy refundsApplication → refunds

Open the next change with its summary and graph already prepared.

CONNECT TO GITHUB

Get started with Astory

Sign in with GitHub, install the Astory GitHub App, and choose your repositories. Scan your architecture, then get updated architecture comparisons automatically as pull requests change.

Get started with GitHub