Skip to content

docs: point planning docs at decision architecture, archive stale build docs - #35

Merged
shreyanshjain7174 merged 1 commit into
mainfrom
docs/decision-alignment
Oct 2, 2026
Merged

shreyanshjain7174 merged 1 commit into
mainfrom
docs/decision-alignment

Conversation

@shreyanshjain7174

Copy link
Copy Markdown
Contributor

What

Point the planning docs at the decision architecture and archive stale build docs.

Why

The planning docs described the old build order. The decision architecture ADR in the operator repo is now the source of truth. The receipt protocol it relies on shipped in v0.1.4 (pkg/receiptspec).

Changes

  • Add a pointer to the decision architecture ADR in the agent and architecture docs.
  • Mark the stale build docs as archived.
  • Docs only. No code changes.

Notes

The ADR link resolves after the operator PR merges.

…ld docs

Signed-off-by: Shreyansh Sancheti <43677304+shreyanshjain7174@users.noreply.github.com>

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot review overview

🟡 Changes recommended

Every new canonical ADR link currently returns 404 on the target repository's main branch.

Review effort: Balanced
Findings: 9 Low severity

Open (9)
What changed in this PR

Updates documentation to reference the operator ADR and label old build plans as archived.

Changes:

  • Adds decision architecture links.
  • Archives 4 stale planning documents.
  • Documents AgentGate’s invariant-layer role.
File Description
README.md Adds invariant-layer guidance.
agentgate-copilot-prompt.md Marks the prompt archived.
agentgate-copilot-instructions.md Marks old instructions archived.
agentgate-architecture.md Marks old architecture archived.
agentgate-agents.md Marks orchestration plans archived.
.planning/​STATE.md Links decision architecture.
.planning/​ROADMAP.md Links decision architecture.
.planning/​REQUIREMENTS.md Links decision architecture.
.planning/​PROJECT.md Links decision architecture.

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

Comment thread .planning/PROJECT.md
Comment thread .planning/REQUIREMENTS.md
Comment thread .planning/ROADMAP.md
Comment thread .planning/STATE.md
Comment thread README.md
Comment thread agentgate-agents.md
Comment thread agentgate-architecture.md
Comment thread agentgate-copilot-instructions.md
Comment thread agentgate-copilot-prompt.md
@shreyanshjain7174
shreyanshjain7174 merged commit 21a43cc into main Oct 2, 2026
2 checks passed
@shreyanshjain7174
shreyanshjain7174 deleted the docs/decision-alignment branch October 4, 2026 09:44
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.

2 participants