markitect-tool/docs/packaging-decision.md

Packaging Decision

Date: 2026-05-03

Decision

markitect-tool starts as a Python 3.12+ package with:

• Distribution name: markitect-tool
• Import package: markitect_tool
• CLI entry point: mkt
• Build backend: setuptools
• Test runner: pytest
• Source layout: src/markitect_tool

Initial Dependencies

Core dependencies:

• markdown-it-py
• PyYAML
• click>=8.0

Optional extras:

• query: jsonpath-ng
• tables: tabulate
• llm: llm-connect
• dev: pytest

Rationale

This follows the WP-0002 dependency classification and keeps the first implementation focused on deterministic markdown parsing and CLI access. The package name avoids legacy markitect.* imports while the mkt entry point matches the PRD.