Wiki Convention - noetl/ai-meta GitHub Wiki
How the ai-meta wiki (this one) relates to the per-repo wikis.
-
Per-repo wikis (
noetl/noetl/wiki,noetl/server/wiki,noetl/worker/wiki, etc.) document that repo's public surface — its API, its module layout, its operational knobs. Mirror the code at the wiki level. -
This wiki (
noetl/ai-meta/wiki) documents the system of repos — cross-repo umbrellas, the ecosystem map, release history, session decisions, and how agents coordinate across them.
When in doubt: if the content is about a single submodule's internals, it belongs in that submodule's wiki. If it spans repos or tracks platform-wide state, it belongs here.
| Page | What |
|---|---|
| Home | Dashboard — active umbrellas, ecosystem map, release pointer |
| Repo Map | Every submodule, its role, its current version, its wiki |
| Releases | Per-repo release log with GitHub Release URLs |
| Sessions Log | Chronological log of agent sessions and what landed |
| Umbrella: * | One page per active ai-task umbrella issue |
| Issue Tracking | Pointer to agents/rules/issue-tracking.md
|
| Wiki Convention | This page |
| Handoffs | Pointer to agents/rules/handoffs.md
|
| Deployment Validation | Pointer to agents/rules/deployment-validation.md
|
| Execution Model | Pointer to agents/rules/execution-model.md
|
| Observability | Pointer to agents/rules/observability.md
|
- The Python API reference, the DSL semantics →
noetl/noetlwiki. - The Rust server's route handlers, the event envelope schema
→
noetl/serverwiki. - The Rust worker's main loop, the metrics surface →
noetl/workerwiki. - The KEDA scaler manifest details, the Helm chart values →
noetl/opswiki. - The Docusaurus engineer-facing architecture (ephemeral
blueprints, ADRs, Appendix H) →
noetl/docssite at https://noetl.dev/docs.
If you find yourself writing repo-specific reference content here, stop and move it to the right wiki.
This wiki is a git submodule of noetl/ai-meta at
repos/ai-meta-wiki/. Updates ride the same pattern as
other wiki updates per
agents/rules/wiki-maintenance.md:
- Edit pages in
repos/ai-meta-wiki/. - Commit + push to
noetl/ai-meta.wiki.gitmaster. - Bump the submodule pointer in ai-meta with a
chore(sync): bump ai-meta-wiki to <sha>commit.
Per-session expectation:
- Add a Sessions Log entry at the top when the session lands meaningful work (issues opened, PRs merged, pointer bumps, design decisions).
- Refresh Home when the active-umbrella table changes (new umbrella, closed umbrella, status change).
- Update Releases when a submodule pointer bump references a new tagged release.
- Touch the relevant
Umbrella-*page when the umbrella's status moves — append a line under "Recent activity" with the date + concrete change.
When you link from this wiki to a per-repo wiki page, use the
full URL:
https://github.com/noetl/<repo>/wiki/<page-slug>. Internal
links inside this wiki use bare slugs like [Home](Home).
When a per-repo wiki page references this dashboard, link to
specific pages here (e.g.
https://github.com/noetl/ai-meta/wiki/Umbrella-Rust-Worker-Migration)
not the Home page — so the cross-link survives Home reorgs.