Skip to content

Add build conventions for v1 - #47

Merged
alp82 merged 4 commits into
mainfrom
docs/build-foundations
Oct 4, 2026
Merged

alp82 merged 4 commits into
mainfrom
docs/build-foundations

Conversation

@alp82

@alp82 alp82 commented Oct 4, 2026

Copy link
Copy Markdown
Contributor

Resolves the decisions in #43, Build foundations: repository layout, message format, and test levels.

  • Adds docs/agents/build.md, which build sessions read first: the hq/, porter/, protocol/, and e2e/ layout, the message format, four test levels behind root commands, continuous integration, and the merge gate.
  • Adds ADR 0007: JSON messages with hand-written types and shared fixtures, with Protocol Buffers as the upgrade path.
  • Merges the two research documents that the decisions use: docs/research/hq-porter-message-format.md and docs/research/build-test-environment.md.
  • Points CLAUDE.md at the build conventions.

Documentation only. No code moves in this pull request. The first build ticket, #46, moves HQ into hq/ and creates the scaffolding.

🤖 Generated with Claude Code

https://claude.ai/code/session_01JLVmUdp5Dq52TKkyJBBMRL

alp82 and others added 4 commits October 4, 2026 14:41
Four test levels for unattended agents, and plain QEMU with the
Ubuntu 24.04 cloud image and cloud-init for virtual machine runs.
Answers #42.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_011wBmMN38K8K549LwRmLXRm
Compare JSON Schema code generation, Protocol Buffers with buf, and
hand-written types with shared fixtures for the HQ to Porter WebSocket
messages. Recommend JSON text frames with hand-written types and shared
fixtures, with Protocol Buffers as the upgrade path.

Resolves #41.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_011wBmMN38K8K549LwRmLXRm
…mat' and 'origin/research/build-test-environment' into docs/build-foundations
Records the decisions from #43: the hq/, porter/, protocol/, and e2e/
layout, JSON messages with shared fixtures, four test levels, and the
merge gate for build sessions.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01JLVmUdp5Dq52TKkyJBBMRL
@alp82
alp82 merged commit dad0690 into main Oct 4, 2026
1 check passed
@alp82
alp82 deleted the docs/build-foundations branch October 4, 2026 13:43
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant