control-surface's workflow docs, protocol notes, templates, prompts and examples, rendered from the repository's Markdown when the site is built. GitHub remains the source of record; every page links its source and its raw file.

docs

documentarchitectureArchitecturedocs/architecture.md · 8 sections documentmethodMethod // Bridgedocs/method.md · 5 sections documentproject instantiation workflowProject Instantiation Workflowdocs/project-instantiation-workflow.md · 4 sections documentadvisor Project surface architectureAdvisor Project Surface Architecturedocs/advisor-project-surface-architecture.md · 12 sections documentadvisor surface compression lossAdvisor-surface compression lossdocs/advisor-surface-compression-loss.md · 5 sections documentcritique protocolCritique protocoldocs/critique-protocol.md · 7 sections documentdomain-authority review protocolDomain-authority review protocoldocs/domain-authority-review-protocol.md · 6 sections

protocol

Notes on the distributable execution-protocol layer. Its carriers are resolved into each repository's AGENTS.md and stay on GitHub; see not rendered, below.

protocol noteprotocol READMEprotocol/ — shared execution protocol (owner)protocol/README.md · 6 sections protocol noteClaude Code adapterprotocol/adapters/claude-code/ — Claude Code adapter artifactsprotocol/adapters/claude-code/README.md · 4 sections

templates

Copyable starters for downstream repo-local files and the external grounding note. They are not live for this repository unless adopted.

templatetemplates READMEtemplates/ — AGENTS carrier authoringtemplates/README.md · 4 sections templatearchitecture templateArchitecture Templatetemplates/architecture.template.md · 7 sections templateCLAUDE templateCLAUDE.mdtemplates/CLAUDE.template.md · 1 sections templateadvisor Project bootstrap templateAdvisor Bootstrap // [SURFACE NAME]templates/advisor-project-bootstrap.template.md · 17 sections templateadvisor Project Instructions template[PROJECT NAME] Advisor Project Instructionstemplates/advisor-project-instructions.template.md · 6 sections template_INDEX project template_INDEX-<project> // GPT Source Index (template)templates/_INDEX-project.template.md · 5 sections

prompts

Reusable prompts and coordinator runbooks.

promptproject instantiation initial promptProject Instantiation Initial Promptprompts/project-instantiation-initial-prompt.md · 6 sections promptClaude Code initial promptClaude Code Initial Promptprompts/claude-code-initial-prompt.md · 5 sections promptrepo nudge promptRepo Source-of-Intent Nudge Promptprompts/repo-nudge-prompt.md promptrepo critique initial promptRepo Critique Initial Promptprompts/repo-critique-initial-prompt.md · 2 sections promptrepo critique synthesis promptRepo Critique Synthesis Promptprompts/repo-critique-synthesis-prompt.md · 2 sections promptrepo critique execution promptRepo Critique Execution Promptprompts/repo-critique-execution-prompt.md · 2 sections promptecology critique initial promptecology-ASK // System Critique // Initial Promptprompts/ecology-critique-initial-prompt.md · 2 sections promptecology critique synthesis promptecology-ASK // System Critique // Synthesis Promptprompts/ecology-critique-synthesis-prompt.md · 2 sections promptecology critique execution promptecology-ASK // System Critique // Execution Promptprompts/ecology-critique-execution-prompt.md · 4 sections promptcross-repo propagation waveCross-repo-propagation-wave runbookprompts/cross-repo-propagation-wave.md · 10 sections promptconvention-aware version preflightConvention-Aware Version Preflightprompts/convention-aware-version-preflight.md · 7 sections promptinter-session coordinationInter-Session Coordinationprompts/inter-session-coordination.md · 13 sections

worked examples

Concise mappings from real ASK projects to this structure.

exampleasset-pipeline-ASKasset-pipeline-ASK Notesexamples/asset-pipeline-ASK/notes.md · 4 sections exampleurban-observatoryurban-observatory Notesexamples/urban-observatory/notes.md · 3 sections

records

Operating records of the diagram folder, rendered from their Markdown.

recorddiagrams READMEDiagrams // illustrativedocs/diagrams/README.md · 7 sections recordtoken mirror MANIFEST_dsa-tokens — local design-system-ASK mirrordocs/diagrams/_dsa-tokens/MANIFEST.md

source views

source viewarchitecture tree sourceRead-only, line-numbered: one source file, in the view the diagram front door links.docs/diagrams/control-surface_architecture-tree.source.js source viewintent-INbox lifecycle sourceRead-only, line-numbered: one source file, in the view the diagram front door links.docs/diagrams/control-surface_intent-inbox-lifecycle.source.js

not rendered

The declaration decides what is rendered, and every Markdown file in the repository's documentation has a declared place. These stay readable on GitHub, and nothing here is browsed at runtime.

  • README.md · the repository front page; its banner image sits outside the deployed site · GitHub
  • AGENTS.md · the repository's workflow rules for executors; the resolved shared block's marker comments are part of its format · GitHub
  • CLAUDE.md · a runtime adapter that imports AGENTS.md · GitHub
  • control-surface.md · the retired Model-A artifact, kept as frozen historical provenance · GitHub
  • docs/workflow-boundary.md · the legacy workflow-boundary doc, kept as frozen historical provenance · GitHub
  • prompts/control-surface-initial-prompt.md · the retired Model-A prompt, kept as frozen historical provenance · GitHub
  • examples/mazeASK/notes.md · frozen historical provenance, outside the repository map · GitHub
  • protocol/AGENTS.shared.md · the shared protocol body, resolved verbatim into each repository's AGENTS.md; its marker comments and untitled form belong to that format · GitHub
  • protocol/fragments/standing-upstream-conformance-grant.md · an opt-in fragment resolved into a consumer's AGENTS.md; it has no title of its own · GitHub
  • protocol/profiles/advisor-project-surface.md · a profile body resolved into consumers' AGENTS.md between marker comments · GitHub
  • protocol/profiles/architecture-uncertain.md · a profile body resolved into consumers' AGENTS.md between marker comments · GitHub
  • protocol/profiles/core-ecology.md · a profile body resolved into consumers' AGENTS.md between marker comments · GitHub
  • templates/AGENTS.template.md · a starter carrying the shared block's marker comments · GitHub
  • templates/grounding-note.template.md · a starter whose second title belongs to the note it produces · GitHub
  • templates/overlays/architecture-uncertain-rules.template.md · an overlay starter whose profile body, between marker comments, is kept byte-identical with protocol/profiles/architecture-uncertain.md · GitHub
  • templates/domain-authority-review-profile.template.md · a starter whose title carries a placeholder written as an HTML tag · GitHub