markitect-main/README.md
tegwick 8b9f599931
All checks were successful
CI Smoke / host-smoke (push) Successful in 0s
CI Smoke / container-smoke (push) Successful in 2s
docs: restore legacy task backing and document successor transition
Assistant: codex
Assistant-Model: gpt-6-astra
Assistant-Session: 01a0e77b-9d43-7432-9301-e5cb6ad05ef6
2026-09-28 12:15:49 +02:00

1.9 KiB

Markitect Main

Legacy Python markdown and knowledge-artifact platform, with a JavaScript editor integration. The repository is transitioning to successor repositories; it has not been fully retired. Start with INTENT.md for current responsibilities and the successor map.

Current work

  • Publication coordination is blocked on TestDrive package and release evidence plus Markitect integration verification. Its readiness definition and repository-structure decision are complete. The remaining tasks retain their original State Hub identities.
  • Successor gap assessment identifies pending decisions about rendering/assets, the older spaces abstraction, and project-operations code. It is an assessment, not permission to remove code.
  • WORK-RECORDS.md is the generated task index; workplans/ contains the authoritative task records.

Working with the legacy code

The Makefile defines make setup, make test, make lint, and make build; make help lists the available commands. These describe the legacy workflow, not a claim that the full suite passes in a fresh checkout.

Capabilities are Git submodules. Inspect git submodule status before using capability targets. The TestDrive submodule was uninitialized during the September 28 review, so make testdrive-jsui-test-all was unavailable. Its legacy URL in .gitmodules may need a local override to the current forge before initialization. Verify the pinned commit and dependency setup before running the integration checks. Do not publish the root npm package as the TestDrive library.

See AGENTS.md for repository and State Hub procedures, INTRODUCTION.md for historical product concepts, and SCOPE.md for the legacy capability inventory.