markitect-tool/docs/workplan-planning-map.md

Workplan Planning Map

Date: 2026-05-03

Purpose

This document captures the current sequencing and priority view for markitect-tool workplans.

State Hub currently supports workstream dependency edges, but it does not yet have native workstream priority/order fields and does not ingest dependency metadata from workplan frontmatter. Until that exists, this file and the workplan frontmatter are the repo source of truth; State Hub dependency edges and descriptions mirror the operational view.

Priority Scale

Priority	Meaning
P0	Current mainline work.
P1	Next enabling architecture or implementation work.
P2	High-value follow-on work, start when trigger conditions are met.
P3	Research-lab or security-sensitive extension work.
complete	Finished foundation or completed decision work.

Current Ordering

Workplan	Priority	Status	Depends On	Current View
MKTT-WP-0001	complete	done	none	Repository foundation is complete.
MKTT-WP-0002	complete	done	MKTT-WP-0001	Legacy scope extraction is complete.
MKTT-WP-0004	complete	done	MKTT-WP-0001, MKTT-WP-0002	Contract framework is complete and informs later validation/generation work.
MKTT-WP-0003	P0	active	MKTT-WP-0001, MKTT-WP-0002, MKTT-WP-0004	Mainline implementation. Continue with P3.5 transform/compose/include.
MKTT-WP-0006	P1	todo	MKTT-WP-0004; task-level trigger: MKTT-WP-0003-T005	Start after transform/composition shape is clear and before serious cache work.
MKTT-WP-0007	P2	todo	MKTT-WP-0006	First practical cache backend use case: AST/JSONPath/SQLite/FTS.
MKTT-WP-0005	P2	todo	MKTT-WP-0003, MKTT-WP-0004	Pick up when generation/form/context or semantic assessment pressure appears.
MKTT-WP-0009	P2	todo	MKTT-WP-0006	Establish access-control gateway before security-sensitive cache/context use.
MKTT-WP-0008	P3	todo	MKTT-WP-0006, MKTT-WP-0007, MKTT-WP-0009	Agent working-memory cache after backend and policy floor are available.

Dependency Notes

The most important nuance is MKTT-WP-0006: it should not wait for every task in MKTT-WP-0003, because it should shape cache architecture before P3.7. It should wait until MKTT-WP-0003-T005 gives transform/composition enough shape to know what cached identities and invalidation rules must preserve.

This is a mixed task/workstream dependency. State Hub does not currently model that natively.

State Hub Mirror

Native State Hub dependency edges should mirror the whole-workstream dependencies:

• MKTT-WP-0002 -> MKTT-WP-0001
• MKTT-WP-0004 -> MKTT-WP-0001
• MKTT-WP-0004 -> MKTT-WP-0002
• MKTT-WP-0003 -> MKTT-WP-0001
• MKTT-WP-0003 -> MKTT-WP-0002
• MKTT-WP-0003 -> MKTT-WP-0004
• MKTT-WP-0006 -> MKTT-WP-0004
• MKTT-WP-0007 -> MKTT-WP-0006
• MKTT-WP-0005 -> MKTT-WP-0003
• MKTT-WP-0005 -> MKTT-WP-0004
• MKTT-WP-0009 -> MKTT-WP-0006
• MKTT-WP-0008 -> MKTT-WP-0006
• MKTT-WP-0008 -> MKTT-WP-0007
• MKTT-WP-0008 -> MKTT-WP-0009