Skip to content

docs: explain the work loop, stack roles, H3 verification and conventions - #16

Merged
Zacharon merged 1 commit into
mainfrom
docs/stack-overview-20261103
Nov 17, 2026
Merged

Zacharon merged 1 commit into
mainfrom
docs/stack-overview-20261103

Conversation

@Zacharon

Copy link
Copy Markdown
Owner

Adds companion docs that explain the AEOS method alongside the existing architecture page:

  • docs/HOW-AEOS-WORKS.md, STACK.md, RUNNER.md, VERIFICATION-H3.md, KNOWLEDGE-MODEL.md, FEATURE-STANDARD.md, CONVENTIONS.md, plus the Mermaid source for the stack loop
  • four read-only role cards under .agent/agents/ and nine blank authoring worksheets under templates/
  • short pointers from README.md and .agent/README.md

Docs only. No runtime, package or site/ change.

Checks run locally: python -B scripts/check_public_boundary.py found nothing (293 files scanned). The whole diff was read for private names, machine paths and claims that are not yet true; none were found.

Saved from an uncommitted worktree (last edited 2026-11-03) during the 2026-11-17 Finish Line run.

🤖 Generated with Claude Code

…owledge-model guides with templates and agent roles

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@Zacharon

Copy link
Copy Markdown
Owner Author

Reviewed the whole diff: 7 docs, 1 Mermaid file, 4 read-only role cards, 9 blank templates, 2 README pointers. No runtime, package or site/ change. No private names, machine paths or account data. Claims checked against the repo: .agent/skills has the eight skills the role-card note mentions, and the docs defer implemented behavior to ARCHITECTURE.md. CI: the boundary scan and Windows package validation both pass. The repo has no Pages, hosting config or deploy workflow, so merging publishes nothing beyond the source. Non-blocking: FEATURE-STANDARD.md overlaps an older unpushed local draft (docs/FEATURE_STANDARD.md on codex/aeos-feature-standard-20261010); this PR's version is the current one.

@Zacharon
Zacharon merged commit e829fda into main Nov 17, 2026
2 checks passed
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