Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
21 commits
Select commit Hold shift + click to select a range
aa13e84
Centralize community file defaults
MariusStorhaug Aug 29, 2026
2cdee02
Normalize contribution guide title
MariusStorhaug Aug 29, 2026
712110b
Remove memory exception guidance
MariusStorhaug Aug 29, 2026
dc47268
Merge main into repository governance
MariusStorhaug Aug 29, 2026
a527c95
Use organization-named context roots
MariusStorhaug Aug 30, 2026
089017e
Align agents file heading standard
MariusStorhaug Aug 30, 2026
c2bfb63
Remove memory repository guidance
MariusStorhaug Aug 30, 2026
0947337
Document optional organization defaults
MariusStorhaug Aug 30, 2026
b1536ea
Define the organization defaults repository surface
MariusStorhaug Aug 30, 2026
791f671
Align standards with central repository roles
MariusStorhaug Aug 30, 2026
85e6da6
Use the repository language standard
MariusStorhaug Aug 30, 2026
3db29b1
Simplify the global agent template
MariusStorhaug Aug 30, 2026
806f7a7
Align agent context routing docs
MariusStorhaug Aug 30, 2026
298c8b8
Use Git for context setup
MariusStorhaug Aug 30, 2026
d1c1e6b
Keep AGENTS router title consistent
MariusStorhaug Aug 30, 2026
1ae908a
Keep agent routers destination-only
MariusStorhaug Aug 30, 2026
64e6533
Document the AGENTS template format
MariusStorhaug Aug 30, 2026
9915ea8
Make AGENTS template repository-level
MariusStorhaug Aug 30, 2026
ab5febe
Keep bootstrap guidance evergreen
MariusStorhaug Aug 30, 2026
0955a02
Move AGENTS template into agentic development docs
MariusStorhaug Aug 30, 2026
9cf392e
Merge branch 'main' into repository-governance
MariusStorhaug Aug 30, 2026
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
9 changes: 0 additions & 9 deletions CONTRIBUTING.md → .github/CONTRIBUTING.md
Original file line number Diff line number Diff line change
Expand Up @@ -113,15 +113,6 @@ conventional-commit prefixes. See
Push every commit, so the remote branch, CI, and the draft pull request always reflect the
current state of the work.

## Agent workspace

Agents working here read organization memory from `~/.msx/memory`, set up by the
[workspace bootstrap](bootstrap/README.md). That bootstrap is user-global: it is installed
once per machine, not per repository.

When a verified lesson is likely to matter again, record it in `~/.msx/memory` and push it
directly to `main`, following that repository's own contribution guide.

See the [README](README.md) for what this repository is and how it is laid out, and the
[Ways of Working](https://msxorg.github.io/docs/Ways-of-Working/) for the conventions every
pull request follows — issue format, PR format, branching, and review etiquette.
15 changes: 5 additions & 10 deletions AGENTS.md
Original file line number Diff line number Diff line change
@@ -1,12 +1,7 @@
# Agent Instructions
# AGENTS

This repository is `github.com/MSXOrg/docs`. Read in this order:
Read in this order:

1. [README.md](README.md) — what this repository is, how it is laid out, and how it builds.
2. [CONTRIBUTING.md](CONTRIBUTING.md) — how a change is made and reviewed here.
3. [src/docs/index.md](src/docs/index.md) — the documentation this repository owns. Follow the index inward.
4. `~/.msx/memory/index.md` — durable lessons from earlier work, read last.

Step 3 is also the MSX organization standard, so nothing governs this repository from above it.

Read nearest first. A local file never overrides a standard, and memory never overrides documentation.
1. README.md - about the repo and what it contains
2. .github/CONTRIBUTING.md - how a change is made and reviewed
3. src/docs/index.md - the documentation this repository owns
1 change: 0 additions & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -36,5 +36,4 @@ src/
docs/ # the documentation content
includes/ # shared snippets (abbreviations, links)
overrides/ # theme overrides
bootstrap/ # the user-global agent workspace setup
```
175 changes: 0 additions & 175 deletions bootstrap/AGENTS.template.md

This file was deleted.

Loading
Loading