---
id: MKTT-WP-0003
type: workplan
title: "Core Markdown Toolkit Implementation"
domain: markitect
status: active
owner: markitect-tool
topic_slug: markitect
created: "2026-05-03"
updated: "2026-05-03"
state_hub_workstream_id: "9fefb57d-985e-4125-8daf-03554844f45e"
---

# MKTT-WP-0003: Core Markdown Toolkit Implementation

## Purpose

Build the first usable `markitect-tool` implementation around the PRD/FRS
contract and the `mkt` CLI.

## P3.1 - Bootstrap package and tests

```task
id: MKTT-WP-0003-T001
status: todo
priority: high
state_hub_task_id: "9d9501fe-6809-4b4f-bda6-ec5e5952ddc7"
```

Create project metadata, package layout, test structure, and a minimal CLI
entry point that can be installed or run locally.

## P3.2 - Implement structured markdown parse contract

```task
id: MKTT-WP-0003-T002
status: todo
priority: high
state_hub_task_id: "7dead033-e249-46b0-9eb3-908ae231a987"
```

Implement FR-001 and FR-002: parse markdown files, preserve headings,
frontmatter, sections, and content blocks, and expose structured output via
API and CLI.

## P3.3 - Implement schema load and validation

```task
id: MKTT-WP-0003-T003
status: todo
priority: high
state_hub_task_id: "36a22def-d415-4c08-a793-836ee52e4308"
```

Implement FR-010 through FR-012: define/derive schemas, validate documents,
and report structured violations with file/location context.

## P3.4 - Implement query and extraction

```task
id: MKTT-WP-0003-T004
status: todo
priority: medium
state_hub_task_id: "e4f72218-601e-488f-a5df-171b91a747d2"
```

Implement FR-030 and FR-031 over the structured representation. Start with a
small query language or JSONPath-like adapter only if it remains simple.

## P3.5 - Implement transform, compose, and include primitives

```task
id: MKTT-WP-0003-T005
status: todo
priority: medium
state_hub_task_id: "205d69eb-dd34-46a5-af0b-cc2de9d213d0"
```

Implement FR-020 through FR-022 as deterministic document operations. Keep
transclusion syntax and resolution rules explicit and testable.

## P3.6 - Implement templating and generation hooks

```task
id: MKTT-WP-0003-T006
status: todo
priority: medium
state_hub_task_id: "307fa072-b1ce-42e8-9309-e2a92e130ae1"
```

Implement FR-040 through FR-042 with deterministic templates first and optional
LLM-assisted hooks supplied by external providers.

Extension point: `EP-MKTT-001`.

## P3.7 - Add caching and incremental processing

```task
id: MKTT-WP-0003-T007
status: todo
priority: low
state_hub_task_id: "236f90e3-1d79-473f-8c57-bcbbde9ece02"
```

Implement FR-070 and FR-071 after the parse/schema contracts are stable.

## Known Technical Debt

```task
id: MKTT-WP-0003-T008
status: todo
priority: medium
state_hub_task_id: "94067c7e-e68b-45be-a1d6-90547eb15422"
```

Resolve `TD-MKTT-001` by adding the implementation scaffold: package metadata,
module layout, test runner, and `mkt` CLI entry point.