Telemachus docs

Start here — this is the map. One home per concern; everything else points to it:

Decisions (the stack + architecture) → decisions/ — the ADRs (001–008) are the source of truth; a stack-at-a-glance index lives in decisions/README.md.
Scope / identity + constraints → ideas/scope-positioning.md. Vision / pillars / the wedge → ideas/thesis.md.
Sequence (rungs + order) → specs/roadmap.md. How-to-build specs → specs/ (data model, foundations, scaffold, streaming-chat, ci-cd-release).
Cross-cutting seams → specs/foundations.md.
Code-level conventions (dev environment, routing, testing, components) → development/.
Status / tasks / open threads + project memory → bd (bd ready, bd prime).
Evidence / research (dated snapshots + deep-dives of other projects) → research/.

Conventions: ADRs are numbered (NNN-*); everything else is named by topic. Each bucket has its own README.md.

Name		Name	Last commit message	Last commit date
Latest commit History 73 Commits
.beads		.beads
.changeset		.changeset
.claude		.claude
.github		.github
.vscode		.vscode
apps/web		apps/web
docs		docs
packages		packages
.commitlintrc.js		.commitlintrc.js
.editorconfig		.editorconfig
.env.example		.env.example
.gitattributes		.gitattributes
.gitignore		.gitignore
.markdownlint-cli2.mjs		.markdownlint-cli2.mjs
.mise.toml		.mise.toml
.oxfmtrc.json		.oxfmtrc.json
.oxlintrc.json		.oxlintrc.json
AGENTS.md		AGENTS.md
CLAUDE.md		CLAUDE.md
docker-compose.yml		docker-compose.yml
knip.jsonc		knip.jsonc
lefthook.yml		lefthook.yml
package.json		package.json
pnpm-lock.yaml		pnpm-lock.yaml
pnpm-workspace.yaml		pnpm-workspace.yaml
turbo.json		turbo.json

Provide feedback