[meta] L4 materialization: decompose remaining work into atomic issues #59
Labels
No labels
W6d-automerge-calibration
agent/claude-code
agent/codex
agent/hermes
agent/iskra
agent/ollama
agent/patchwarden
automerge-candidate
class/security-sensitive
cutover-gate
dependency/blocked
dependency/blocks-others
dependency/cross-repo
dependency/needs-confirmation
domain:agents
domain:ci
domain:docs
domain:forgejo
domain:infra
domain:memory
domain:runtime
domain:signal
domain:ux
flow/architecture
flow/blocked
flow/deployed
flow/done
flow/implementation
flow/intake
flow/maintained
flow/observed
flow/ready
flow/refining
flow/retired
flow/review
iterating
judge/codex-candidate
judge/hermes-candidate
judge/low-confidence
judge/needs-refinement
judge/operator-needed
judge/p0
judge/p1
judge/p2
judge/p3
judge/park
judge/patchwarden-candidate
judge/stale-priority
kind/adr
kind/bug
kind/chore
kind/feature
kind/infra
kind/ops
kind/refactor
kind/research
large-impact
merge/auto
merge/manual
merge/manual-dependency-conflict
merge/manual-failing-tests
merge/manual-merge-conflict
merge/manual-missing-review
merge/manual-operator-preference
merge/manual-red-zone
merge/manual-security-sensitive
merge/manual-unclear-scope
merge/manual-unknown
meta
mode:operator-only
mode:patchwarden-iskra-approved
mode:safe-auto
needs-operator-decision
needs-triage
not-ready
observed/erroring
observed/needs-followup
observed/pending
observed/retire-candidate
observed/unused
observed/used
operator-emotional
owner-attention
phase/02
phase/03
priority:p0
priority:p1
priority:p2
priority:p3
proposed
ready-for-agent
ready-for-operator
recovery
review:claude-reviewed
review:codex-reviewed
review:dziadek-reviewed
review:needs-human
risk/exposure
risk/process
risk/product
risk/runtime
safety:external-write
safety:no-prod-mutation
safety:prod-impact
safety:secret-touch
size/large
size/medium
size/small
size/tiny
size/unknown
source/adr
source/agent-generated
source/manual
source/operator-chat
source/voice-note
status:blocked
status:codex-ready
status:merged:pending-evidence
status:needs-evidence
status:operator-needed
status:parked
tier/full
tier/lite
tier/stacked
tier:0-platform-substrate
tier:1-iskra-value-layer
tier:2-tools-products-modules
type:bug
type:chore
type:docs
type:feat
type:policy
type:research
No milestone
No project
No assignees
2 participants
Notifications
Due date
No due date set.
Dependencies
No dependencies set.
Reference
pdurlej/platform#59
Loading…
Add table
Add a link
Reference in a new issue
No description provided.
Delete branch "%!s()"
Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?
Pilot meta-decomposition issue per PR #58 follow-up plan + Oracle review insights.
This is the FIRST meta-issue created under the new self-replicating model. The decomposing agent's output (5-10
proposedatomic issues) will be reviewed by operator/orchestrator before any of those atomic children getready-for-agentlabel and become swarm-pickable.The decomposing agent does NOT implement any L4 work in this issue. Decomposition only.
Plan section / source
Original plan:
/Users/pd/.claude/plans/super-fajnie-generalnie-zgadzam-bright-piglet.md§"Layer 4 — Materialization (3 parallel waves)".Why this layer matters
L4 is the materialization layer of the original plan — the layer that produces the actual platform repo artifacts (manifests, master prompts, control plane skeleton, Forgejo Actions, migration plans, ACL seed) from the L0-L3 foundation. Most of L4 has been partially executed across the 2026-04-30 to 2026-05-04 sessions, but no formal audit exists of what's done vs. what remains. Without that audit, the swarm cannot know which atomic issues are real outstanding work vs. already-completed.
Until L4 is audited and decomposed, Phase 03 (control plane: platformctl) cannot start cleanly — Phase 03 depends on L4.6 (platformctl skeleton) being complete and L4.3 (module manifests) being at least 30 modules in v2.
Extracted context
Suggested atomic issues to create
Best-effort first pass; the decomposing agent must AUDIT the current repo state for each suggested item before opening, AND open only what genuinely remains. Each issue uses
atomic_task.mdtemplate fully.chore(audit): L4.3 module manifests audit — count v2-complete vs gap(audit-only; outputs are paths needing v2 fields, NOT manifest changes)feat(control-plane): platformctl validate subcommand minimum viable(per L4.6; schema + token-count + secrets-scan; against existing modules/)feat(control-plane): platformctl plan subcommand stub(per L4.6; SSH dry-run via Tailscale adapter; no apply yet)feat(control-plane): platformctl health subcommand(per L4.6; rollup of smoke.sh per-module results)docs(migrations): vault-to-infisical secret-by-secret cutover plan(per L4.9; depends on RS audit; produces inventory + ordering + rollback)docs(network): tailscale ACL .hujson — fill-in TODO comments with actual tagOwners + groups + ACLs(per L4.10; comment-heavy; never auto-applied)chore(verify): L4-Verify suite — deterministic checks over manifests + prompts + platformctl + workflows(per L4-Verify section)docs(prompts): .codex/instructions per-module template(per L4.7+4.8; small Jinja2 template + 1 example instantiation)Decomposing agent: validate this list against repo state. Drop items that are already done; add items that are missing. Stay within 5-10 children.
Decomposition rules (per Oracle review 2026-05-05)
proposed(orneeds-triageif the decomposing agent has open questions). NOTready-for-agent.atomic_task.mdtemplate fully: spec sources whitelist, extracted context (5-30 quoted lines per source), do-not-read list, allowed touched paths, escape hatch, unknowns / owner questions.spec sources readdisclosure comment on this meta-issue before close.Acceptance criteria for THIS meta-issue
/Users/pd/.claude/plans/super-fajnie-generalnie-zgadzam-bright-piglet.md§L4 + L4-Verify in full.modules/have N v2 manifests? doescontrol-plane/platformctl/have which subcommands? doesmigrations/have what? doesnetwork/tailscale-acl.hujsonexist with TODOs?).atomic_task.mdtemplate fully, each carryingproposedlabel (orneeds-triage).## Tracesection.## Suggested approach.ready-for-agentto those approved.Stop conditions
The decomposing agent should STOP and ask the operator (via comment +
owner-attentionlabel) if:platformctl applysemantics not yet decided).PLATFORM_CHARTER.md).Trace
super-fajnie-generalnie-zgadzam-bright-piglet.md); this meta-issue 2026-05-05.Spec sources read — disclosure
Decomposing agent: glm
Date: 2026-05-05
Primary spec sources (from whitelist)
modules/*/module.yaml— all 81 module manifests (glob scanned, grep for schema_version/predecessor: 0 matches)schema/module.schema.json— v1 schema (read)schema/module.schema.v2.json— v2 schema with ADHD counters (read)PLATFORM_CHARTER.md— §3 review-by-impact, §5 secrets, §6 Codex, §11 sacred paths, §12 docs (read in full from prior audit)PLATFORM_CONSTITUTION.md— identity doc (read in prior audit)migrations/vault-to-infisical.md— 242 lines, Phase 0 done (read lines 1-50, verified Phase structure)network/tailscale-acl.hujson— 237 lines, 5 TODOs (read lines 1-50, grep for TODO: 5 matches)control-plane/platformctl/cli.py— 461 lines, 29 cmd_* functions (read lines 50-150, grep for cmd_)control-plane/platformctl/plan.py— 137 lines (read lines 1-30)control-plane/platformctl/apply.py— 137 lines (read lines 1-30)Additional files read (beyond spec sources)
control-plane/platformctl/manifest.py— to verify jsonschema is NOT wired up (reason: validate issue needs accurate current state)control-plane/platformctl/schema.py— to check schema loading exists (reason: validate issue scope)prompts/directory — glob scan, 10 files found (reason: verify L4.4 completion)control-plane/platformctl/tests/— glob scan, 8 test files found (reason: verify testing infrastructure)forgejo/branch-protection.json— read in prior audit (reason: CI context)control-plane/forgejo-actions/apply.yaml— read in prior audit (reason: CI context)README.md— read to find INDEX.md reference (reason: added issue #68).forgejo/issue_template/atomic_task.md— read template structure (reason: compliance with decomposition rules)modules/vault/module.yaml— lifecycle: sunset, blast_radius: platform-data (reason: vault-to-infisical issue)modules/infisical/module.yaml— auth check (reason: vault-to-infisical issue)Files deliberately NOT read (context conservation)
control-plane/platformctl/tools/run_review.py(~1000 lines) — not relevant to L4 decompositionbaseline/— immutable, not auditedstate/— execution ledger, not L4 artifactDecomposition result — 7 children opened
Dropped (2 items from suggested list)
1.
feat(control-plane): platformctl plan subcommand stub— DROPPEDRationale:
plan.pyalready exists (137 lines) with full implementation: SSH dry-run via Tailscale adapter, desired-vs-observed diff, plan artifact output.cmd_planis wired in cli.py. This is complete, not a stub.2.
feat(control-plane): platformctl health subcommand— DROPPEDRationale:
cmd_healthalready exists in cli.py (lines 127-148). It loads manifests and returns lifecycle+host+status. The Phase 04 gate ("real probes via Loki") is explicit in the code comment. This is a skeleton-by-design, not a missing feature.Added (1 item not in suggested list)
7.
docs(repo): INDEX.md — refresh or deprecate(#68) — ADDEDRationale: README.md references INDEX.md but no such file exists. PLATFORM_CHARTER.md §12 lists it as a top-level doc. Cold-start agents (per PR #58 onboarding flow) will hit this dead end. Not in original #59 list because it was not visible from the plan §L4 — it emerged from reading README after PR #58 rewrite.
Children opened (all as glm, all labeled
proposed)Dependencies between atomics
Decomposing agent did NOT implement any child in this session.
This meta-issue is ready for operator review. Children carry
proposedlabel and should not receiveready-for-agentuntil operator approves.pdurlej/platformapdurlej/iskra-openclaw— co gdzie mieszka #74Completion close — meta-issue done (2026-05-06)
GLM's pilot decomposition (commented 2026-05-05) produced 7 atomic children:
Audit by claude orchestrator (PR #69, merged) found ~14% hallucination ratio — well under sunset threshold per criteria in
state/glm-sunset-watch.md. GLM stays as canary 3+3 voice.Lessons learned codified in
state/agent-execution-template.md(PR #69) — applied to all subsequent meta-decompositions including #70 (closed today).Closing this meta-issue. Children continue their own lifecycle independently.