Skip to content

Commit 1f2b6e6

Browse files
claudeclaude
committed
docs(wiki): add wiki docs/wikis/ — Home page with satellite map
Create docs/wikis/Home.md with developer-ecosystem overview, the full satellite map (git-tools/repo-management/scaffolding/developer-ux tracks), language policy summary, and governance section. Add 0.2-AI-MANIFEST.a2ml. https://claude.ai/code/session_01PhqGcxCqkMdJtR6NWq56Hx
1 parent 9a28802 commit 1f2b6e6

2 files changed

Lines changed: 104 additions & 0 deletions

File tree

‎docs/wikis/0.2-AI-MANIFEST.a2ml‎

Lines changed: 16 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,16 @@
1+
# SPDX-License-Identifier: MPL-2.0
2+
---
3+
### [META]
4+
id: "wikis-track"
5+
level: 2
6+
parent: "../0.1-AI-MANIFEST.a2ml"
7+
8+
---
9+
### [AI_MANIFEST]
10+
description: |
11+
Long-form collaborative documentation and project knowledge base.
12+
This directory mirrors the content structure of the project wiki.
13+
14+
invariants:
15+
- "Primary wiki format MUST be Markdown (.md) or AsciiDoc (.adoc)"
16+
- "Satellite map MUST be kept current when satellites are added/removed"

‎docs/wikis/Home.md‎

Lines changed: 88 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,88 @@
1+
<!-- SPDX-License-Identifier: MPL-2.0 -->
2+
# Developer Ecosystem
3+
4+
**The central hub for all hyperpolymath development-workflow tools** — git operations, repository management, scaffolding, code analysis, and developer experience.
5+
6+
This wiki is the *signpost* — canonical docs live in the repo at [`docs/`](https://github.com/hyperpolymath/developer-ecosystem/tree/main/docs). Edit [`docs/wikis/`](https://github.com/hyperpolymath/developer-ecosystem/tree/main/docs/wikis) in the code repo, not directly in the wiki UI.
7+
8+
---
9+
10+
## Start here
11+
12+
| If you want to… | Go to |
13+
|---|---|
14+
| Understand what's in the ecosystem | [README.adoc](https://github.com/hyperpolymath/developer-ecosystem/blob/main/README.adoc) |
15+
| Find a specific tool | [satellite map below](#satellite-map) |
16+
| See current project state | [.machine_readable/6a2/STATE.a2ml](https://github.com/hyperpolymath/developer-ecosystem/blob/main/.machine_readable/6a2/STATE.a2ml) |
17+
| See governance / contractiles | [.machine_readable/contractiles/](https://github.com/hyperpolymath/developer-ecosystem/tree/main/.machine_readable/contractiles/) |
18+
19+
---
20+
21+
## What Developer Ecosystem is
22+
23+
Developer Ecosystem is a **meta-repository** — a coordination hub and scaffold for 30+ satellite projects that improve how developers work. Satellites are organized into four tracks:
24+
25+
- **Git Tools** — forge management, branch workflows, repo unification, multi-forge mirroring
26+
- **Repo Management** — automation, health monitoring, audit-grade tooling
27+
- **Scaffolding** — project template generation, boilerplate
28+
- **Developer UX** — dashboards, doc reconciliation, language evangelism
29+
30+
Each satellite is a real project with its own repo and its own machine-readable governance; this parent repo provides the shared standards, CI templates, and estate-wide coordination.
31+
32+
## Satellite map
33+
34+
### Git Tools
35+
36+
| Satellite | Purpose |
37+
|---|---|
38+
| **git-hud** | Unified git platform dashboard — GitHub, GitLab, Gitea, Bitbucket in one UI |
39+
| **gitloom** | Branch management and workflow weaving |
40+
| **git-reunify** | Safe repo reunification and history merging |
41+
| **git-seo** | Repo discoverability tooling |
42+
| **polysafe-gitfixer** | Git backup merger |
43+
| **vext** | IRC commit notifications |
44+
45+
### Repo Management
46+
47+
| Satellite | Purpose |
48+
|---|---|
49+
| **oikos** | Ecological code health and analysis metrics |
50+
| **robot-repo-automaton** | Automated repo management |
51+
| **grim-repo** | Audit-grade repo tooling |
52+
| **robot-vacuum-cleaner** | Repo tidying bot |
53+
54+
### Scaffolding
55+
56+
| Satellite | Purpose |
57+
|---|---|
58+
| **scaffoldia** | Community-driven project scaffolding and templates |
59+
60+
### Developer UX
61+
62+
| Satellite | Purpose |
63+
|---|---|
64+
| **rescript-evangeliser** | AffineScript/ReScript migration assistant and IDE helpers |
65+
| **recon-silly-ation** | Doc reconciliation system |
66+
| **nickel-config-reporter** | Config auditing against Nickel schemas |
67+
68+
## Language policy
69+
70+
Tools in this ecosystem follow the **hyperpolymath standard** language policy:
71+
72+
- **Primary application code**: AffineScript (`.affine`) — compiles to typed-wasm or Deno-ESM
73+
- **CLI tools / systems**: Rust
74+
- **Scripts / automation**: Deno (Bash for simple cases)
75+
- **Backend services**: Gleam or Elixir (BEAM ecosystem)
76+
- **Data analysis**: Julia
77+
- **Legacy**: ReScript/TypeScript exists in some satellites; no new `.res`/`.ts` files
78+
79+
See [`.claude/CLAUDE.md`](https://github.com/hyperpolymath/developer-ecosystem/blob/main/.claude/CLAUDE.md) for the full policy.
80+
81+
## Governance
82+
83+
- **Licence**: MPL-2.0 (or PMPL-1.0 where explicitly declared)
84+
- **Machine-readable state**: [`.machine_readable/6a2/`](https://github.com/hyperpolymath/developer-ecosystem/tree/main/.machine_readable/6a2/)
85+
- **Contractiles**: 6-verb governance (`must/trust/bust/adjust/dust/intend`) in [`.machine_readable/contractiles/`](https://github.com/hyperpolymath/developer-ecosystem/tree/main/.machine_readable/contractiles/)
86+
- **Bot directives**: [`.machine_readable/bot_directives/`](https://github.com/hyperpolymath/developer-ecosystem/tree/main/.machine_readable/bot_directives/) — methodology + coverage + debt for AI agents
87+
- **Security policy**: [SECURITY.md](https://github.com/hyperpolymath/developer-ecosystem/blob/main/SECURITY.md)
88+
- **Open issues**: [github.com/hyperpolymath/developer-ecosystem/issues](https://github.com/hyperpolymath/developer-ecosystem/issues)

0 commit comments

Comments
 (0)