coulomb/markitect-tool
4
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
Markdown-native knowledge toolkit providing a contract layer between semi-structured markdown and structured knowledge systems.
20 commits 1 branch 0 tags 617 KiB
Find a file
tegwick 4fc891c076 chore(consistency): sync task status from DB [auto] 
Updated by fix-consistency on 2026-05-03:
  - update .custodian-brief.md for markitect-tool
2026-05-03 23:43:34 +02:00
.claude/rules State-hub connect and initial workplans 2026-05-03 20:43:12 +02:00
docs Followup workplan for more in depth document information processing 2026-05-03 23:05:11 +02:00
examples Contract framework with markdown-native contracts utilizing fenced YAML blocks 2026-05-03 22:51:13 +02:00
src/markitect_tool Contract framework with markdown-native contracts utilizing fenced YAML blocks 2026-05-03 22:51:13 +02:00
tests Contract framework with markdown-native contracts utilizing fenced YAML blocks 2026-05-03 22:51:13 +02:00
wiki Intent and specification files 2026-05-03 19:26:51 +02:00
workplans Followup workplan for more in depth document information processing 2026-05-03 23:05:11 +02:00
.custodian-brief.md chore(consistency): sync task status from DB [auto] 2026-05-03 23:43:34 +02:00
.gitignore Initial commit 2026-05-03 16:43:00 +00:00
CLAUDE.md State-hub connect and initial workplans 2026-05-03 20:43:12 +02:00
INTENT.md Intent and specification files 2026-05-03 19:26:51 +02:00
LICENSE Initial commit 2026-05-03 16:43:00 +00:00
pyproject.toml Initial schemas and validation with extension workplan 2026-05-03 22:12:46 +02:00
README.md Parse Markdown files into a structured Python object 2026-05-03 21:37:00 +02:00
sbom-tools.yaml Initial schemas and validation with extension workplan 2026-05-03 22:12:46 +02:00

README.md

markitect-tool

markitect-tool is a markdown-native toolkit and CLI for turning semi-structured Markdown into structured, queryable, reusable knowledge artifacts.

This repository is the syntax-layer successor to the in-scope core of markitect-main. Its product boundary is defined in INTENT.md and the requirements documents in wiki/.

Start Here

  • INTENT.md - project purpose, boundaries, and design principles
  • wiki/ProductRequirementsDocument.md - product scope and success criteria
  • wiki/FunctionalRequirementsSpecification.md - observable functional behavior
  • docs/markitect-main-scope-assessment.md - migration assessment from markitect-main
  • workplans/ - source-of-truth implementation and migration plans

State Hub

The repo is registered with the Custodian State Hub as markitect-tool under the markitect domain. See docs/state-hub-integration.md.

Development

Run the tests:

python3 -m pytest

Try the parser CLI from a checkout:

PYTHONPATH=src python3 -m markitect_tool parse README.md --format tree