---
id: RREG-WP-0003
type: workplan
title: "Repository Ability Registry — Automatic Repository Exploration"
domain: capabilities
repo: repo-registry
status: active
owner: codex
topic_slug: foerster-capabilities
created: "2026-04-26"
updated: "2026-04-26"
state_hub_workstream_id: "c121d462-f2e4-45d3-9d2d-9c04a3556953"
---

# RREG-WP-0003 — Automatic Repository Exploration

## Goal

Make the first-run experience feel like a useful product: a user can register a
repository, ask the registry to explore it, and quickly land on a populated,
source-linked ability profile. The system must preserve the core trust model:
deterministic facts are observed, interpreted ability claims are reviewable, and
canonical registry truth is either explicitly approved by a human or by a clearly
configured trusted automation mode.

## P0: One-Click Register And Explore

```task
id: RREG-WP-0003-T01
status: in_progress
priority: high
state_hub_task_id: "ab718ce7-d38f-4080-9385-99be1bf80475"
```

Add a UI and API flow that registers a repository and immediately starts analysis
when requested. In the UI, the repository registration form should offer a clear
`Explore after registration` option enabled by default. The resulting screen should
show analysis progress/result, observed facts, candidate abilities, and the next
recommended action without requiring the user to hunt for the analysis button.

Acceptance: registering `/home/worsch/repo-registry` from the UI can complete an
analysis run in one flow and land on the reviewable candidate graph.

## P0: Self-Analysis Quality Pass

```task
id: RREG-WP-0003-T02
status: todo
priority: high
state_hub_task_id: "d0d98e1b-8d21-4bdf-af58-edbb34e8a929"
```

Use this repository as the first golden demo target. Improve deterministic
scanning and candidate generation where needed so repo-registry produces a useful
ability map for itself: repository ingestion, deterministic scanning, candidate
review workflow, discovery/search, UI curation, and operational/state-hub
coordination should be visible as source-linked claims.

Acceptance: a self-analysis run produces non-trivial, source-linked candidate
abilities and capabilities that a curator would recognize as the repo's real
purpose.

## P1: Guided Review To Populated Registry

```task
id: RREG-WP-0003-T03
status: todo
priority: medium
state_hub_task_id: "5c4b5bb1-390c-4782-bb70-104b0006fe67"
```

Polish the candidate review path so the user can approve, edit, merge, or reject
generated claims from a single coherent screen. After approval, route to the
approved ability map and make search/discovery/export actions immediately visible.

Acceptance: after self-analysis, a user can populate the canonical registry with
approved entries in one review session and then see them in search, discovery, and
export.

## P1: Trusted Auto-Populate Mode

```task
id: RREG-WP-0003-T04
status: todo
priority: medium
state_hub_task_id: "076385fe-4dbf-4aca-b89f-c7372d9eebd9"
```

Add an explicit opt-in automation mode for local/demo use that approves a
candidate graph automatically after analysis. This must be visibly labeled and
record a review decision showing that the approval was automated. The default
production posture should remain review-first.

Acceptance: a local user can choose fully automated exploration that registers,
analyzes, and populates the approved registry, while default mode still requires
review.

## P2: First-Run Delight And Diagnostics

```task
id: RREG-WP-0003-T05
status: todo
priority: low
state_hub_task_id: "b812a7fb-19ef-418a-83a2-15bf26fd3f4a"
```

Add clear success states, useful empty states, and diagnostics for common first-run
problems such as invalid local paths, inaccessible Git URLs, empty repos, and runs
that produce only weak candidates.

Acceptance: trying the product on repo-registry itself feels understandable and
useful even when a scan finds gaps or weak evidence.