---
id: KONT-WP-0001
type: workplan
title: "Repository Foundation And State Hub Integration"
domain: markitect
repo: kontextual-engine
status: done
owner: codex
topic_slug: markitect
created: "2026-05-03"
updated: "2026-05-05"
state_hub_workstream_id: "52ff9c49-edcf-4150-8895-c6b31f5aa075"
---

# KONT-WP-0001: Repository Foundation And State Hub Integration

## Purpose

Establish `kontextual-engine` as a properly scoped, State Hub connected
successor repo before implementation begins.

## F1.1 - Register repo with State Hub

```task
id: KONT-WP-0001-T001
status: done
priority: high
state_hub_task_id: "f11fbf85-6841-464d-b076-73811a161a8e"
```

Create or verify the State Hub repo record for `kontextual-engine` in the
`markitect` domain with the local host path `/home/worsch/kontextual-engine`.

## F1.2 - Add State Hub repo integration files

```task
id: KONT-WP-0001-T002
status: done
priority: high
state_hub_task_id: "7a56ea42-1690-4bd6-9640-29c3863717a6"
```

Add `CLAUDE.md`, `.custodian-brief.md`, `SCOPE.md`, `tpsc.yaml`, and
`docs/state-hub-integration.md` so future sessions can orient consistently.

## F1.3 - Establish authoritative workplan set

```task
id: KONT-WP-0001-T003
status: done
priority: high
state_hub_task_id: "950f43a4-e815-42b5-a167-eb48f0706d4d"
```

Create initial workplans for foundation, legacy scope extraction, and first
implementation slices using the ADR-001 file-backed convention.

## F1.4 - Run State Hub consistency sync

```task
id: KONT-WP-0001-T004
status: done
priority: high
state_hub_task_id: "6fefec5f-eff8-402a-ad87-bf4821468a3d"
```

From `/home/worsch/the-custodian/state-hub`, run:

```bash
make fix-consistency REPO=kontextual-engine
```

Verify the repo has no consistency failures after State Hub indexes the
workplan files.

## F1.5 - Decide initial implementation stack

```task
id: KONT-WP-0001-T005
status: done
priority: medium
state_hub_task_id: "616e0476-7b65-4079-b545-13e0fc9436f7"
```

Choose the first implementation stack, dependency manager, test command, and
service framework. Record the decision before adding application code.

Output: `docs/stack-decision.md`; executable scaffold added in `pyproject.toml`,
`src/kontextual_engine/`, and `tests/`.