Living index of what’s decided, what’s shipped, what’s in flight, and what’s next. Hand-curated today; will become frontmatter-driven once the corpus is large enough to be worth automating.
Decisions accepted
| # | Title | Date |
|---|---|---|
| 0001 | Merge oxflow and oxflow-docs into one monorepo | 2026-04-20 |
| 0002 | Wiki viewer is Quartz v4 | 2026-04-20 |
| 0003 | bmad | 2026-04-20 |
| 0004 | Every knowledge-base doc carries YAML frontmatter | 2026-04-20 |
Research in the corpus
| Date | Topic | Author |
|---|---|---|
| 2026-04-17 | Database analysis — Neon + S3 in Sydney | Bilal Jawadi (@bilaljawadi45) |
| 2026-04-20 | DevOps & infrastructure baseline | Ibrahim Hussain (@ibrahim_h) |
| 2026-04-20 | Agentic coding + PR review strategy | Bilal Jawadi |
| 2026-04-20 | CodeRabbit vs DIY review agents | Bilal Jawadi |
| 2026-04-20 | Multica and Claude Managed Agents | Bilal Jawadi |
| 2026-04-20 | Multica + BMAD orchestration | Bilal Jawadi |
| 2026-04-20 | Shared project memory across agents | Bilal Jawadi |
Specs
The formal entity model lives under docs. Top-level areas:
- Foundation — concept-map, business-rules, roles-permissions, nfr
- Layer 1 — Work hierarchy — tender, estimate, heading, item, worksheet
- Layer 2 — Building blocks — resource, recipe
- Layer 3 — Pricing & procurement — price-book, adjudication, subcontract-package
- Layer 4 — Commercials & submission — commercials
- Layer 5 — Reference data — company, user, unit, categorization, codes, reference-rate, program-and-task
Done
- Monorepo migration (2026-04-20) —
oxflow+oxflow-docsmerged into361-coders-nz/oxflow-hub. Full history preserved. - Wiki viewer (2026-04-21) — Quartz v4 live at
oxflow-wiki.design.3sixtyone.coon the 361 admin Vercel team. - Authoring contract + linter (2026-04-21) —
CLAUDE.mdrewritten as a schema-first contract with per-type frontmatter checklist.meta/scripts/lint-wiki.pyenforces it locally; idempotent normaliser (normalize-wiki.py) ran across the corpus so every page renders with exactly one h1 and has seeded tags.
Not yet
- BMAD sync wiring — waits for the real codebase repo to exist. Contract and skeleton script are in
meta/bmad-sync/. - CI lint enforcement — GitHub Action running
lint-wiki.py --checkon every PR. - Quartz theme polish — match
BRANDING.mdtokens (fonts already right, colour palette roughly keyed off the oxFlow ink + accent tokens; component-level polish still to do). - Retire the legacy custom SPA at
app/— left running today because the wiki isn’t yet the only reading surface; retire once the team is reading here by default.
Conventions
Every agent and human writing in this repo follows the same contract:
- Authoring rules — CLAUDE (the one you must read first)
- Frontmatter schema —
meta/frontmatter-schema.md(authoritative field definitions) - Templates —
templates/README.md(which to copy, for what) - Linter —
python3 meta/scripts/lint-wiki.py --check(run before you PR) - Team roster —
TEAM.md(handle ↔ real name) - Visual system —
BRANDING.md(tokens + named HTML components)
Meetings
- 2026-04-17 Oxcon design workshop (cleaned transcript)
Daily logs
- 2026-04-17 — Ibrahim Houissa (initial migration from Google Drive)
This page will become generated once the corpus grows enough to be worth automating. For now, update it in the same PR as the doc you’re adding.