Skip to content

fabcity/planetai-coordination

Repository files navigation

planetai-coordination

Coordination layer for the PLANETAI program. The dashboard explains what we have built, surfaces the decisions that shaped it, and lists the open work-tracks where partners can plug in.

Lives at coord.planetai.fab.city. Deliberately separate from planetai_publish so coordination scaffolding doesn't churn underneath the live observatory and paper, and so the coordination layer can keep developing on its own cadence.

What's here

Surface What it is Source
/index.html Front door — framing + what changed + what needs you + open tracks hand-written
/about.html Narrative for cold visitors — what is PLANETAI, how we got here hand-written
/decisions/ Decision log — every non-trivial PLANETAI decision with reasoning + supersession chain YAML, generated
/reviews/ Active review queue + history (sub-agent attribution surfaced) YAML, generated (scaffold)
/waves/ Evolution timeline — what shipped when and why YAML, generated (scaffold)
/pilots/ One page per bioregional pilot (Barcelona · Boston · Santiago · Bali) YAML + markdown, generated (scaffold)
/tracks/ Seven open work-tracks — pilot deep-descriptions, Bali hyperlocal dashboard, fab lab network activation, Hamburg + CBA metrics, FAB26 actions, funding scenarios, other funding YAML, generated (scaffold)
/canonical/ One-click index of every canonical artifact (paper, observatory, app v18, data manifest) YAML, generated (scaffold)
/people/ Who is who, roles, time zones, what they review YAML, generated (scaffold)

Build

python3 scripts/build.py

Walks every *.yaml under decisions/, reviews/, etc., and writes HTML alongside (e.g. decisions/2026-05-02_applicant-org-pivot.yamldecisions/2026-05-02_applicant-org-pivot.html). Also regenerates decisions/index.html (and the equivalents for other surfaces).

Dependencies: Python 3.10+ and PyYAML. pip install pyyaml.

Contributing

Each piece of state is one YAML file. Schema reference at scripts/schemas.md (to add). To add or update an entry, edit the YAML, run the build, commit both YAML and generated HTML.

If you're a partner without GitHub access, email or Slack the change to Tomas / Lucas; they will land it for you.

Sister repos

Licence

Curation, narrative, and YAML content under CC-BY-4.0. Build scripts under MIT (scripts/LICENSE-MIT).

Maintained by Fab City and the PLANETAI partner network.

About

Coordination layer for PLANETAI — decision log, reviews, tracks, pilots, waves.

Resources

License

Contributing

Stars

0 stars

Watchers

0 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors