torbenandClaude Opus 5.5
f9056c04f7
Files changed: - .gitea/workflows/ci.yml - .gitignore - .vibe/hooks.toml - AGENTS.md - CHANGES.md - EVALS.md - INSTALL-MCP.md - INSTALL.md - README.md - VERSION - docs/dev/development.md - docs/explanation/README.md - docs/explanation/architecture.md - docs/explanation/language-boundaries.md - docs/explanation/telemetry-and-evaluation.md - docs/how-to/README.md - docs/how-to/browse-with-obsidian.md - docs/how-to/capture-repository-docs.md - docs/how-to/export-guidelines.md - docs/how-to/ingest-a-source.md - docs/how-to/maintain-the-wiki.md - docs/how-to/query-the-wiki.md - docs/how-to/run-the-weekly-review.md - docs/how-to/set-up-the-mcp-server.md - docs/how-to/trace-and-score-sessions.md - docs/how-to/troubleshoot.md - docs/how-to/update-an-instance.md - docs/reference/README.md - docs/reference/commands/distribution-and-versioning.md - docs/reference/commands/instance-health.md - docs/reference/commands/raw-material-and-uploads.md - docs/reference/commands/telemetry.md - docs/reference/commands/types-instructions-and-docs.md - docs/reference/configuration.md - instructions/dev/dev-setup.md - instructions/dev/doc-pull-through.md - instructions/dev/stack-build/SKILL.md - instructions/dev/testing-conventions.md - instructions/dev/version-parts.md - instructions/setup-instance.md - instructions/upgrade-instance.md - reports/CONTRACT.md - tools/.coveragerc - tools/CONTRACT.md - tools/README.md - tools/chemenu/commands/dist_cmd.py - tools/chemenu/commands/docs_verify.py - tools/chemenu/commands/doctor.py - tools/chemenu/commands/eval_cmd.py - tools/chemenu/commands/git_publish.py - tools/chemenu/commands/upload_cmd.py - tools/chemenu/commands/version_cmd.py - tools/chemenu/evals/__init__.py - tools/chemenu/evals/scorecard.py - tools/chemenu/evals/trajectory.py - tools/chemenu/telemetry/policy.py - tools/chemenu/tests/test_dist_cmd.py - tools/chemenu/tests/test_git_publish.py - tools/chemenu/tests/test_instructions_shell.py - tools/chemenu/tests/test_pipeline_l0.py - tools/chemenu/toc.py Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01SnAJ7Z3CpVD3PRbN73QtU2
23 lines
1.4 KiB
Markdown
23 lines
1.4 KiB
Markdown
# Explanation
|
|
|
|
Why the stack is built the way it is. These pages are background for humans and agents alike:
|
|
read by link or on request, never as instruction, and they carry no normative sentence - a rule
|
|
lives in `AGENTS.md` or a `CONTRACT.md`, and a page here only gives its reasons.
|
|
|
|
- [architecture.md](architecture.md) - what the stack is made of, and how its parts divide the
|
|
work
|
|
- [telemetry-and-evaluation.md](telemetry-and-evaluation.md) - how the stack observes what an
|
|
agent did, and how that record turns into a score
|
|
- [pipeline-rationale.md](pipeline-rationale.md) - why the pipeline has four stages
|
|
- [ownership-and-templates.md](ownership-and-templates.md) - why a `.template` split exists, and
|
|
why an instance comes only from a release
|
|
- [language-boundaries.md](language-boundaries.md) - why the control plane is English everywhere
|
|
and the KB language is a value
|
|
- [why-gates-are-code.md](why-gates-are-code.md) - why the gates are code rather than instruction
|
|
- [version-model.md](version-model.md) - why a version number answers a compatibility question
|
|
and a migration question separately
|
|
- [knowledge-and-commitment.md](knowledge-and-commitment.md) - why commitments live in a task
|
|
tracker rather than in `kb/`
|
|
- [model-and-effort-selection.md](model-and-effort-selection.md) - which model and effort suit
|
|
which kind of session, for the harness that has to choose
|