---
id: SOUL-WP-0001
type: workplan
title: "Research repository foundation and State Hub registration"
domain: agents
repo: soul-frame
status: active
owner: grok
topic_slug: soul-frame
priority: high
created: "2026-08-09"
updated: "2026-08-09"
---

# SOUL-WP-0001 — Research repository foundation

## Goal

Establish the Soul Frame research repository as operable: layout from the
research program, standing INTENT, research instruments, concept stubs, State Hub
registration, and hub-synced workplans for the research sequence.

Baseline conceptual draft: `SoulFrameIntroduction.md`  
Research agenda: `ResearchProgram.md` (from `history/260809-SoulFrameResearchProgram.md`)

## Depends on

- None (founding workplan)

## Parallel / follow-on

- **SOUL-WP-0002** — Phase I Foundations (starts after instruments exist)
- Later phases remain proposed until prior phase synthesis is sufficient

## Tasks

### T01 — Repository structure per research program

```task
id: SOUL-WP-0001-T01
status: done
priority: high
```

Create the layout from `ResearchProgram.md` §10:

- Root instruments: Terminology, Claims, OpenQuestions, ThoughtExperiments
- `research/` workstream directories
- `sources/`, `concepts/`, `paper/`
- Seed concept stubs and instrument templates

**Done when:** tree matches the proposed research repository layout.

---

### T02 — INTENT.md and SCOPE.md

```task
id: SOUL-WP-0001-T02
status: done
priority: high
```

Write standing purpose (`INTENT.md`) and operational boundaries (`SCOPE.md`)
aligned with the research stance (systems framework, not consciousness theory).

**Done when:** both files exist and are linked from `README.md`.

---

### T03 — Phase workplans for the research sequence

```task
id: SOUL-WP-0001-T03
status: done
priority: high
```

Author workplans SOUL-WP-0002 through SOUL-WP-0008 covering research phases
I–VII from `ResearchProgram.md` §11, with tasks, dependencies, and priorities.

**Done when:** phase workplan files exist under `workplans/`.

---

### T04 — Register repo with State Hub

```task
id: SOUL-WP-0001-T04
status: done
priority: high
```

Register `soul-frame` under domain `agents` (classification in
`.repo-classification.yaml`), host path, agent instruction stubs as needed.

**Done when:** `GET /repos/soul-frame` succeeds with local path on this host.

---

### T05 — fix-consistency write-back of hub IDs

```task
id: SOUL-WP-0001-T05
status: todo
priority: high
```

Commit workplans, run `make fix-consistency REPO=soul-frame` so C-06 creates
workstreams and writes `state_hub_workstream_id` / task IDs into files.

**Done when:** each SOUL-WP file has hub IDs; consistency check is clean or
warnings-only.

---

### T06 — README orientation for operators

```task
id: SOUL-WP-0001-T06
status: done
priority: medium
```

README documents start-here docs, layout, and research phase summary.

**Done when:** new operator can navigate INTENT → ResearchProgram → workplans
without tribal knowledge.