Skip to content

docs: multi-agent contributor onboarding sweep + Constitution v1.1.0. Principle XIII.#2932

Merged
ten9876 merged 1 commit into
mainfrom
auto/docs-multi-agent-contributor-onboarding-sweep--Con
May 22, 2026
Merged

docs: multi-agent contributor onboarding sweep + Constitution v1.1.0. Principle XIII.#2932
ten9876 merged 1 commit into
mainfrom
auto/docs-multi-agent-contributor-onboarding-sweep--Con

Conversation

@ten9876

@ten9876 ten9876 commented May 22, 2026

Copy link
Copy Markdown
Collaborator

Restructures AetherSDR's contributor-onboarding documentation around
the project's actual multi-agent contribution model: at least six
distinct AI tools touch the codebase (AetherClaude orchestrator,
Claude Code, OpenAI Codex, GPT 5.5 Pro, GitHub Copilot, contributor-
side IDE agents). Each tool has its own well-known file at a
different path, and the previous topology (CLAUDE.md as the sole
canonical) left every other agent reading conventions by accident.

Changes:

  • AGENTS.md (new): canonical project guide. All previous CLAUDE.md
    content moved here, retitled to be agent-neutral. Single source of
    truth for project-wide guidance.
  • CLAUDE.md: slimmed 311 → 68 lines. Now a thin pointer to AGENTS.md
    plus Claude-Code-specific notes (git ship alias, ~/.claude paths).
  • GEMINI.md (new): thin pointer for Gemini Code Assist with 6 inline
    must-knows.
  • .github/copilot-instructions.md (new): same pattern for GitHub
    Copilot.
  • All tool-specific files point directly to AGENTS.md — no
    pointer-to-pointer chains.

Constitution v1.0.1 → 1.1.0 (MINOR amendment):

  • Adopts 7 new principles from Cisco's Foundry Constitution
    (https://github.com/CiscoDevNet/foundry-security-spec):
    VIII Evidence Over Assertion, IX Surface Only What Survives,
    X Claims Are Atomic And Mortal, XI Fixes Are Demonstrated,
    XII Sandbox By Infrastructure Not By Prompt,
    XIII The Operator Outranks Every Agent (promoted from Governance),
    XIV Persist Atomically.
  • Total principle count: 7 → 14. First 7 unchanged (AetherSDR-
    domain conventions); last 7 codify defensive engineering for the
    multi-agent contribution model.
  • CONSTITUTION.md (new): byte-identical root mirror of
    .specify/memory/constitution.md so AI tools reading the repo
    root find it without spec-kit path knowledge.
  • Each new principle is grounded in a real AetherSDR incident
    (PR Fix panadapter layout and floating restore #2780 stale-snapshot revert → Principle X; PR feat(audio): RN2 (RNNoise) toggle on Aetherial Tube Pre-Amp TX (#2813) #2816 alloc-
    free claim verification → Principle VIII; etc.).

New: Issue / PR Claim Protocol (AGENTS.md):

  • AI agents reviewing/commenting on or merging PRs must assign
    themselves via gh issue edit / gh pr edit --add-assignee @me.
  • Carve-out: AetherClaude (@aethersdr-agent) auto-triages every
    new issue/PR, so adding yourself alongside its assignment is
    expected — only avoid double-assigning when another non-AetherClaude
    agent is already engaged.
  • Operational implementation of Principle X (Claims Are Atomic And
    Mortal): assignees list is the visible cross-agent claim signal.

New: docs/COMMIT-SIGNING.md:

  • Walks contributors through SSH or GPG signing setup on Windows /
    macOS / Linux / WSL / Raspberry Pi.
  • Top of doc has explicit AI Assistant Instructions section so an
    agent pointed at the doc can walk the contributor through setup
    in their actual environment without further prompting.
  • Per-OS copy-paste prompts also included for contributors using AI
    IDEs (Claude Code, Cursor, Copilot chat, ChatGPT) who want a
    ready-made invocation.

Updated: CONTRIBUTING.md + CLAUDE.md / AGENTS.md pointers:

  • Constitution reference promoted to step 2 in the Submitting Code
    checklist.
  • Commit signing section rewritten to lead with the new doc and
    AI-assistant invocation, with SSH quick-reference inline.
  • Principle counts updated everywhere (7 → 14).

Principle XIII (Operator Outranks Every Agent) is cited because
the entire restructure exists to ensure the operator's authoritative
voice reaches every agent reading the project, regardless of which
tool the agent runs as.

Foundry-spec conformance verified: all 14 structural elements
(SYNC IMPACT REPORT, Field table, Purpose, Core Principles, "Why
inviolable" rationales, Governance subsections Amendment/Precedence/
Scope/Versioning/Compliance review/Downstream artifacts, MAJOR/MINOR/
PATCH versioning, Foundry reference) present in CONSTITUTION.md.

Co-Authored-By: Claude Opus 4.7 (1M context) noreply@anthropic.com

… Principle XIII.

Restructures AetherSDR's contributor-onboarding documentation around
the project's actual multi-agent contribution model: at least six
distinct AI tools touch the codebase (AetherClaude orchestrator,
Claude Code, OpenAI Codex, GPT 5.5 Pro, GitHub Copilot, contributor-
side IDE agents). Each tool has its own well-known file at a
different path, and the previous topology (CLAUDE.md as the sole
canonical) left every other agent reading conventions by accident.

Changes:

- AGENTS.md (new): canonical project guide. All previous CLAUDE.md
  content moved here, retitled to be agent-neutral. Single source of
  truth for project-wide guidance.
- CLAUDE.md: slimmed 311 → 68 lines. Now a thin pointer to AGENTS.md
  plus Claude-Code-specific notes (git ship alias, ~/.claude paths).
- GEMINI.md (new): thin pointer for Gemini Code Assist with 6 inline
  must-knows.
- .github/copilot-instructions.md (new): same pattern for GitHub
  Copilot.
- All tool-specific files point directly to AGENTS.md — no
  pointer-to-pointer chains.

Constitution v1.0.1 → 1.1.0 (MINOR amendment):

- Adopts 7 new principles from Cisco's Foundry Constitution
  (https://github.com/CiscoDevNet/foundry-security-spec):
  VIII Evidence Over Assertion, IX Surface Only What Survives,
  X Claims Are Atomic And Mortal, XI Fixes Are Demonstrated,
  XII Sandbox By Infrastructure Not By Prompt,
  XIII The Operator Outranks Every Agent (promoted from Governance),
  XIV Persist Atomically.
- Total principle count: 7 → 14. First 7 unchanged (AetherSDR-
  domain conventions); last 7 codify defensive engineering for the
  multi-agent contribution model.
- CONSTITUTION.md (new): byte-identical root mirror of
  .specify/memory/constitution.md so AI tools reading the repo
  root find it without spec-kit path knowledge.
- Each new principle is grounded in a real AetherSDR incident
  (PR #2780 stale-snapshot revert → Principle X; PR #2816 alloc-
  free claim verification → Principle VIII; etc.).

New: Issue / PR Claim Protocol (AGENTS.md):

- AI agents reviewing/commenting on or merging PRs must assign
  themselves via gh issue edit / gh pr edit --add-assignee @me.
- Carve-out: AetherClaude (@aethersdr-agent) auto-triages every
  new issue/PR, so adding yourself alongside its assignment is
  expected — only avoid double-assigning when another non-AetherClaude
  agent is already engaged.
- Operational implementation of Principle X (Claims Are Atomic And
  Mortal): assignees list is the visible cross-agent claim signal.

New: docs/COMMIT-SIGNING.md:

- Walks contributors through SSH or GPG signing setup on Windows /
  macOS / Linux / WSL / Raspberry Pi.
- Top of doc has explicit AI Assistant Instructions section so an
  agent pointed at the doc can walk the contributor through setup
  in their actual environment without further prompting.
- Per-OS copy-paste prompts also included for contributors using AI
  IDEs (Claude Code, Cursor, Copilot chat, ChatGPT) who want a
  ready-made invocation.

Updated: CONTRIBUTING.md + CLAUDE.md / AGENTS.md pointers:

- Constitution reference promoted to step 2 in the Submitting Code
  checklist.
- Commit signing section rewritten to lead with the new doc and
  AI-assistant invocation, with SSH quick-reference inline.
- Principle counts updated everywhere (7 → 14).

Principle XIII (Operator Outranks Every Agent) is cited because
the entire restructure exists to ensure the operator's authoritative
voice reaches every agent reading the project, regardless of which
tool the agent runs as.

Foundry-spec conformance verified: all 14 structural elements
(SYNC IMPACT REPORT, Field table, Purpose, Core Principles, "Why
inviolable" rationales, Governance subsections Amendment/Precedence/
Scope/Versioning/Compliance review/Downstream artifacts, MAJOR/MINOR/
PATCH versioning, Foundry reference) present in CONSTITUTION.md.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@ten9876 ten9876 enabled auto-merge (squash) May 22, 2026 01:15
@ten9876 ten9876 self-assigned this May 22, 2026
@ten9876 ten9876 merged commit 5c782bb into main May 22, 2026
3 checks passed
@ten9876 ten9876 deleted the auto/docs-multi-agent-contributor-onboarding-sweep--Con branch May 22, 2026 01:24
G6PWY-Chris pushed a commit to G6PWY-Chris/AetherSDR that referenced this pull request Jun 22, 2026
… Principle XIII. (aethersdr#2932)

Restructures AetherSDR's contributor-onboarding documentation around
the project's actual multi-agent contribution model: at least six
distinct AI tools touch the codebase (AetherClaude orchestrator,
Claude Code, OpenAI Codex, GPT 5.5 Pro, GitHub Copilot, contributor-
side IDE agents). Each tool has its own well-known file at a
different path, and the previous topology (CLAUDE.md as the sole
canonical) left every other agent reading conventions by accident.

Changes:

- AGENTS.md (new): canonical project guide. All previous CLAUDE.md
  content moved here, retitled to be agent-neutral. Single source of
  truth for project-wide guidance.
- CLAUDE.md: slimmed 311 → 68 lines. Now a thin pointer to AGENTS.md
  plus Claude-Code-specific notes (git ship alias, ~/.claude paths).
- GEMINI.md (new): thin pointer for Gemini Code Assist with 6 inline
  must-knows.
- .github/copilot-instructions.md (new): same pattern for GitHub
  Copilot.
- All tool-specific files point directly to AGENTS.md — no
  pointer-to-pointer chains.

Constitution v1.0.1 → 1.1.0 (MINOR amendment):

- Adopts 7 new principles from Cisco's Foundry Constitution
  (https://github.com/CiscoDevNet/foundry-security-spec):
  VIII Evidence Over Assertion, IX Surface Only What Survives,
  X Claims Are Atomic And Mortal, XI Fixes Are Demonstrated,
  XII Sandbox By Infrastructure Not By Prompt,
  XIII The Operator Outranks Every Agent (promoted from Governance),
  XIV Persist Atomically.
- Total principle count: 7 → 14. First 7 unchanged (AetherSDR-
  domain conventions); last 7 codify defensive engineering for the
  multi-agent contribution model.
- CONSTITUTION.md (new): byte-identical root mirror of
  .specify/memory/constitution.md so AI tools reading the repo
  root find it without spec-kit path knowledge.
- Each new principle is grounded in a real AetherSDR incident
  (PR aethersdr#2780 stale-snapshot revert → Principle X; PR aethersdr#2816 alloc-
  free claim verification → Principle VIII; etc.).

New: Issue / PR Claim Protocol (AGENTS.md):

- AI agents reviewing/commenting on or merging PRs must assign
  themselves via gh issue edit / gh pr edit --add-assignee @me.
- Carve-out: AetherClaude (@aethersdr-agent) auto-triages every
  new issue/PR, so adding yourself alongside its assignment is
  expected — only avoid double-assigning when another non-AetherClaude
  agent is already engaged.
- Operational implementation of Principle X (Claims Are Atomic And
  Mortal): assignees list is the visible cross-agent claim signal.

New: docs/COMMIT-SIGNING.md:

- Walks contributors through SSH or GPG signing setup on Windows /
  macOS / Linux / WSL / Raspberry Pi.
- Top of doc has explicit AI Assistant Instructions section so an
  agent pointed at the doc can walk the contributor through setup
  in their actual environment without further prompting.
- Per-OS copy-paste prompts also included for contributors using AI
  IDEs (Claude Code, Cursor, Copilot chat, ChatGPT) who want a
  ready-made invocation.

Updated: CONTRIBUTING.md + CLAUDE.md / AGENTS.md pointers:

- Constitution reference promoted to step 2 in the Submitting Code
  checklist.
- Commit signing section rewritten to lead with the new doc and
  AI-assistant invocation, with SSH quick-reference inline.
- Principle counts updated everywhere (7 → 14).

Principle XIII (Operator Outranks Every Agent) is cited because
the entire restructure exists to ensure the operator's authoritative
voice reaches every agent reading the project, regardless of which
tool the agent runs as.

Foundry-spec conformance verified: all 14 structural elements
(SYNC IMPACT REPORT, Field table, Purpose, Core Principles, "Why
inviolable" rationales, Governance subsections Amendment/Precedence/
Scope/Versioning/Compliance review/Downstream artifacts, MAJOR/MINOR/
PATCH versioning, Foundry reference) present in CONSTITUTION.md.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
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