Skip to content

Throughstone v1.0.0

Choose a tag to compare

View all tags
@mherschberg mherschberg released this 31 May 14:52
· 294 commits to main since this release
v1.0.0
9cc4ac3
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

Throughstone v1.0.0 — the first public release. 🧱

Throughstone is an architecture-first project scaffold for building real software with an AI coding agent (Claude Code, Codex, …). You bring a rough idea; the scaffold and your agent turn it into a planned, documented, well-architected project — starting with the architecture, never a mystery box.

What it does

  • Think before you code — the first STEP produces architecture docs and decision records (ADRs), no application code, so the foundation is deliberate.
  • Decisions get recorded — versioned architecture docs (the what) and ADRs (the why).
  • Work in runnable units — phases → steps → substeps, each small enough for an agent to execute cleanly in a fresh context.
  • Plain Markdown + a one-time Bash wizard (init.sh) — nothing to trust but text you can read.
  • Works with any agent — thin AGENTS.md / CLAUDE.md pointers to one canonical context; the whole handoff is a single message: "Read AGENTS.md and follow it."
  • Solo or team modes, multi-repo or mono-repo layouts, and per-project license stamping.

Also in this release — brand & web presence

  • Brand identity: wordmark, logo set, palette, and type system (brand/BRAND.md).
  • Landing page live at https://throughstone.org.
  • GitHub social preview card.

Getting started

Click "Use this template", then follow the Quickstart in the README.

License: BSD-3-Clause · © 2026 Mark A. Herschberg · Throughstone™

Assets 2
Loading