Repository navigation
docs: five builds — pick what you are building, and a gate that keeps public links public - #1
Merged
Merged
Conversation
…te or a town Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
…s public
A developer arriving here could not tell which of five very different things they were building, and three of
the five had no guide at all. docs/builds.md names them (an app · a behaviour · a service agent · an estate · a
town), says how to tell which one you are doing, and sends you to exactly one guide.
New guides for the two that had none:
- build-a-service-agent.md — the two shapes (hosted: no app at all; self-hosted: the Service Host embedded),
the four birthrights a charter must finish or stop, how another person's agent reaches it under HER grant,
and the verification whose fifth row is the one that fails in practice.
- authoring-skills.md — the execution contract in a playbook's frontmatter, field by field, so a capability is
defined once and the agent surfaces and UX behaviour are projections of it.
- estate-anatomy.md — the parts of an estate in substrate terms, public for the first time.
check:public-links is the mechanism, not the intention. This kit is the public face of private source
repositories, and the easy mistake is a link into one: it renders for us and 404s for everyone else. The gate
found nine already here — the skills corpus, the source monorepo and the findings ledger were all linked into
private repositories from the public README. They now point at the live corpus, the site and the audits page.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
rpedersen3
changed the title
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
A developer arriving at this kit could not tell which of five very different things they were building, and three of the five had no guide at all.
docs/builds.mdnames them — an app · a behaviour · a service agent · an estate · a town — says how to tell which one you are doing, and sends you to exactly one guide.New guides for the ones that had none:
docs/build-a-service-agent.md— the two shapes (hosted: no app at all; self-hosted: the Service Host embedded), the four birthrights a charter must finish or stop, how another person's agent reaches it under her grant, and a verification whose fifth row is the one that fails in practice. Honest aboutservice-hostbeing early andcreate-app --kind servicenot yet shipped.docs/authoring-skills.md— the execution contract in a playbook's frontmatter, field by field, so a capability is defined once and the agent surfaces and UX behaviour are projections of it.docs/estate-anatomy.md— the parts of an estate in substrate terms, public for the first time.docs/operating.md— the ladder for builds 4 and 5.scripts/check-public-links.mjsis the mechanism, wired intopnpm check. This kit is the public face of private source repositories, and the easy mistake is a link into one: it renders for us and 404s for everyone else. The gate found nine already here — the skills corpus, the source monorepo and the findings ledger were all linked into private repositories from the public README.Companion changes, already on their repos' default branches:
ap-town(new-town runbook, publish-an-estate, its own link gate), the site (/build/paths,/architecture/operating), and the skills site's landing page. Those link here, so merging this is what makes them resolve.🤖 Generated with Claude Code