A collection of reference standards for technical specifications, designed to be consumed and observed by AI agents.
Published as a Jekyll-based GitHub Pages site at: https://newadventuresinit.github.io/specpack
Three standards:
- MiniMark — a minimal subset of CommonMark for AI agent authoring.
- riVer — a versioning scheme for textual content in agentic environments.
- Specify — conventions for writing AI-consumable technical specifications.
Each standard is published in two forms:
- A rendered HTML page for humans to read.
- A raw Markdown file at a stable URL for AI agents to fetch directly,
e.g.
https://newadventuresinit.github.io/specpack/minimark/2026-03-31/MiniMark-2026-03-31.md.
For directory structure, URL conventions, how raw Markdown is served, how to publish new spec versions with _script/publish.rb, and theme customizations, see CLAUDE.md.
Site code and published specifications are licensed under CC BY 4.0. See LICENSE for the full text.