# 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:

```bash
python3 -m pytest
```

Try the parser CLI from a checkout:

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