Files
markitect-tool/registry/capabilities/capability.communication.markitect-toolkit.md
tegwick fc36e9a043 Draft capability entry (reuse-surface REUSE-WP-0017-T04, cohort 2)
Honest first-pass maturity vector grounded in README/docs/tests present
in this repo; no invented evidence. Flagged for human review before
publish. See reuse-surface history/2026-07-06-coverage-classification.md.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
2026-07-06 19:41:37 +02:00

5.0 KiB

id, name, summary, owner, status, domain, tags, maturity, external_evidence, discovery, availability, relations, evidence, consumer_guidance, promotion_history
id name summary owner status domain tags maturity external_evidence discovery availability relations evidence consumer_guidance promotion_history
capability.communication.markitect-toolkit Markitect Markdown Toolkit And CLI Markdown-native toolkit and CLI (mkt) for turning semi-structured Markdown into structured, queryable, reusable knowledge artifacts; syntax-layer successor to markitect-main. markitect-tool draft communication
markitect
markdown
cli
toolkit
discovery availability
current target confidence rationale
D4 D5 high Extensive documentation set: INTENT.md, wiki/ProductRequirementsDocument.md, wiki/FunctionalRequirementsSpecification.md, docs/getting-started.md, docs/cli-reference.md (generated), docs/api-reference.md (generated), docs/source-adapter-contract.md, docs/source-adapter-migration.md, docs/performance-notes.md — an unusually complete documentation set among the swept repos.
current target confidence rationale
A2 A3 high Ships a documented CLI (`mkt`) and public API with generated reference docs; already consumed by sibling adapter repos (markitect-filter for source adapters, markitect-quarkdown for render adapters) via a versioned adapter contract.
completeness reliability
level confidence basis satisfied_expectations broken_expectations out_of_scope_expectations
C2 low scope_vs_intent_and_consumer_expectations
source-adapter contract with two implementing sibling repos (markitect-filter, markitect-quarkdown)
generated CLI and API reference documentation
documented migration path from markitect-main
level confidence basis known_reliability_risks
R1 low consumer_quality_signals
performance notes describe 'local performance posture' only — not independently load-tested in this sweep
intent includes excludes assumptions use_cases research_memos
Turn semi-structured Markdown into structured, queryable, reusable knowledge artifacts via a markdown-native CLI and API, as the syntax-layer successor to markitect-main.
`mkt` CLI
public API for structured Markdown artifacts
versioned source/render adapter contracts (implemented by markitect-filter, markitect-quarkdown)
application-layer infospace lifecycle (see infospace-bench)
knowledge-operations runtime (see kontextual-engine)
current_level target_level current_artifacts target_artifacts consumption_modes
A2 A3
`mkt` CLI
Python package (`markitect-tool`) with generated API reference
cli
library import
depends_on supports related_to
documentation tests consumer_feedback bug_reports incidents
INTENT.md
wiki/ProductRequirementsDocument.md
docs/cli-reference.md
docs/api-reference.md
tests/
recommended_for not_recommended_for known_limitations
consumers needing markdown-native structured knowledge extraction and a stable CLI/API
needs for full infospace lifecycle management (see infospace-bench) or knowledge-operations runtime (see kontextual-engine)
performance characterized only informally (local notes, not independently load-tested)

Markitect Markdown Toolkit And CLI

Overview

markitect-tool is a markdown-native toolkit and CLI (mkt) that turns semi-structured Markdown into structured, queryable, reusable knowledge artifacts. It is the syntax-layer successor to markitect-main, with a versioned adapter contract already implemented by two sibling repos (markitect-filter for source adapters, markitect-quarkdown for render adapters).

Assessment notes

Discovery

Extensive documentation set: INTENT.md, wiki/ProductRequirementsDocument.md, wiki/FunctionalRequirementsSpecification.md, docs/getting-started.md, docs/cli-reference.md (generated), docs/api-reference.md (generated), docs/source-adapter-contract.md, docs/source-adapter-migration.md, docs/performance-notes.md — an unusually complete documentation set among the swept repos.

Availability

Ships a documented CLI (mkt) and public API with generated reference docs; already consumed by sibling adapter repos (markitect-filter for source adapters, markitect-quarkdown for render adapters) via a versioned adapter contract.

Completeness

First-pass honest assessment from the REUSE-WP-0017 coverage campaign (reuse-surface). No external consumer feedback exists yet; levels reflect scope-vs-intent documentation quality, not internal code quality.

Reliability

No production consumer telemetry exists yet; reliability level is intentionally conservative pending REUSE-WP-0019 reuse-telemetry evidence.

Promotion checklist

  • ID follows capability.<domain>.<name> pattern
  • Maturity enums match specs/CapabilityMaturityStandard.md
  • external_evidence is populated separately from maturity
  • Relations reference valid capability IDs (none yet)
  • Index entry added in registry/indexes/capabilities.yaml