diff --git a/.scratch/distributed-inference-network/PRD.md b/docs/PRD.md similarity index 100% rename from .scratch/distributed-inference-network/PRD.md rename to docs/PRD.md diff --git a/docs/agents/issue-tracker.md b/docs/agents/issue-tracker.md index a2f08fb..41e6d2b 100644 --- a/docs/agents/issue-tracker.md +++ b/docs/agents/issue-tracker.md @@ -1,18 +1,18 @@ # Issue tracker: Local Markdown -Issues and PRDs for this repo live as markdown files in `.scratch/`. +Issues and PRDs for this project live as markdown files under `docs/`. ## Conventions -- One feature per directory: `.scratch//` -- The PRD is `.scratch//PRD.md` -- Implementation issues are `.scratch//issues/-.md`, numbered from `01` +- The PRD is `docs/PRD.md` (narrative) and `docs/prd.json` (machine-readable story list used by ralph) +- Implementation issues (user stories) are `docs/issues/-.md`, numbered from `01` - Triage state is recorded as a `Status:` line near the top of each issue file (see `triage-labels.md` for the role strings) +- ADRs (architecture decisions) are `docs/adr/-.md`, numbered from `0001` - Comments and conversation history append to the bottom of the file under a `## Comments` heading ## When a skill says "publish to the issue tracker" -Create a new file under `.scratch//` (creating the directory if needed). +Create a new file under `docs/issues/` following the numbering convention. ## When a skill says "fetch the relevant ticket" diff --git a/.scratch/distributed-inference-network/issues/01-monorepo-scaffold.md b/docs/issues/01-monorepo-scaffold.md similarity index 100% rename from .scratch/distributed-inference-network/issues/01-monorepo-scaffold.md rename to docs/issues/01-monorepo-scaffold.md diff --git a/.scratch/distributed-inference-network/issues/02-two-node-shard-pipeline.md b/docs/issues/02-two-node-shard-pipeline.md similarity index 100% rename from .scratch/distributed-inference-network/issues/02-two-node-shard-pipeline.md rename to docs/issues/02-two-node-shard-pipeline.md diff --git a/.scratch/distributed-inference-network/issues/03-tracker-registration-and-routing.md b/docs/issues/03-tracker-registration-and-routing.md similarity index 100% rename from .scratch/distributed-inference-network/issues/03-tracker-registration-and-routing.md rename to docs/issues/03-tracker-registration-and-routing.md diff --git a/.scratch/distributed-inference-network/issues/04-node-client-startup.md b/docs/issues/04-node-client-startup.md similarity index 100% rename from .scratch/distributed-inference-network/issues/04-node-client-startup.md rename to docs/issues/04-node-client-startup.md diff --git a/.scratch/distributed-inference-network/issues/05-openai-compatible-gateway.md b/docs/issues/05-openai-compatible-gateway.md similarity index 100% rename from .scratch/distributed-inference-network/issues/05-openai-compatible-gateway.md rename to docs/issues/05-openai-compatible-gateway.md diff --git a/.scratch/distributed-inference-network/issues/06-solana-stake-and-settlement.md b/docs/issues/06-solana-stake-and-settlement.md similarity index 100% rename from .scratch/distributed-inference-network/issues/06-solana-stake-and-settlement.md rename to docs/issues/06-solana-stake-and-settlement.md diff --git a/.scratch/distributed-inference-network/issues/07-fraud-detection-slash.md b/docs/issues/07-fraud-detection-slash.md similarity index 100% rename from .scratch/distributed-inference-network/issues/07-fraud-detection-slash.md rename to docs/issues/07-fraud-detection-slash.md diff --git a/.scratch/distributed-inference-network/issues/08-probationary-period-and-bans.md b/docs/issues/08-probationary-period-and-bans.md similarity index 100% rename from .scratch/distributed-inference-network/issues/08-probationary-period-and-bans.md rename to docs/issues/08-probationary-period-and-bans.md diff --git a/.scratch/distributed-inference-network/issues/09-p2p-shard-swarm.md b/docs/issues/09-p2p-shard-swarm.md similarity index 100% rename from .scratch/distributed-inference-network/issues/09-p2p-shard-swarm.md rename to docs/issues/09-p2p-shard-swarm.md diff --git a/.scratch/distributed-inference-network/issues/10-meshnet-sdk.md b/docs/issues/10-meshnet-sdk.md similarity index 100% rename from .scratch/distributed-inference-network/issues/10-meshnet-sdk.md rename to docs/issues/10-meshnet-sdk.md diff --git a/.scratch/distributed-inference-network/issues/11-binary-wire-format.md b/docs/issues/11-binary-wire-format.md similarity index 100% rename from .scratch/distributed-inference-network/issues/11-binary-wire-format.md rename to docs/issues/11-binary-wire-format.md diff --git a/.scratch/distributed-inference-network/issues/12-real-pytorch-model-backend.md b/docs/issues/12-real-pytorch-model-backend.md similarity index 100% rename from .scratch/distributed-inference-network/issues/12-real-pytorch-model-backend.md rename to docs/issues/12-real-pytorch-model-backend.md diff --git a/.scratch/distributed-inference-network/issues/13-coverage-first-shard-assignment.md b/docs/issues/13-coverage-first-shard-assignment.md similarity index 100% rename from .scratch/distributed-inference-network/issues/13-coverage-first-shard-assignment.md rename to docs/issues/13-coverage-first-shard-assignment.md diff --git a/.scratch/distributed-inference-network/issues/14-tracker-as-node.md b/docs/issues/14-tracker-as-node.md similarity index 100% rename from .scratch/distributed-inference-network/issues/14-tracker-as-node.md rename to docs/issues/14-tracker-as-node.md diff --git a/.scratch/distributed-inference-network/issues/15-ralph-agent-agnostic-status-aware.md b/docs/issues/15-ralph-agent-agnostic-status-aware.md similarity index 100% rename from .scratch/distributed-inference-network/issues/15-ralph-agent-agnostic-status-aware.md rename to docs/issues/15-ralph-agent-agnostic-status-aware.md diff --git a/.scratch/distributed-inference-network/issues/16-mining-cli-ux.md b/docs/issues/16-mining-cli-ux.md similarity index 100% rename from .scratch/distributed-inference-network/issues/16-mining-cli-ux.md rename to docs/issues/16-mining-cli-ux.md diff --git a/.scratch/distributed-inference-network/issues/17-p2p-gossip-relay-ssl.md b/docs/issues/17-p2p-gossip-relay-ssl.md similarity index 100% rename from .scratch/distributed-inference-network/issues/17-p2p-gossip-relay-ssl.md rename to docs/issues/17-p2p-gossip-relay-ssl.md diff --git a/.scratch/distributed-inference-network/issues/18-two-machine-lan-test.md b/docs/issues/18-two-machine-lan-test.md similarity index 100% rename from .scratch/distributed-inference-network/issues/18-two-machine-lan-test.md rename to docs/issues/18-two-machine-lan-test.md diff --git a/.scratch/distributed-inference-network/issues/19-binary-data-plane-and-peer-weight-transfer.md b/docs/issues/19-binary-data-plane-and-peer-weight-transfer.md similarity index 100% rename from .scratch/distributed-inference-network/issues/19-binary-data-plane-and-peer-weight-transfer.md rename to docs/issues/19-binary-data-plane-and-peer-weight-transfer.md diff --git a/.scratch/distributed-inference-network/issues/20-memory-budget-shard-slots-and-dropout-relocation.md b/docs/issues/20-memory-budget-shard-slots-and-dropout-relocation.md similarity index 100% rename from .scratch/distributed-inference-network/issues/20-memory-budget-shard-slots-and-dropout-relocation.md rename to docs/issues/20-memory-budget-shard-slots-and-dropout-relocation.md diff --git a/.scratch/distributed-inference-network/issues/20-tracker-node-hardening.md b/docs/issues/20-tracker-node-hardening.md similarity index 100% rename from .scratch/distributed-inference-network/issues/20-tracker-node-hardening.md rename to docs/issues/20-tracker-node-hardening.md diff --git a/.scratch/distributed-inference-network/issues/21-route-timeout-flag.md b/docs/issues/21-route-timeout-flag.md similarity index 100% rename from .scratch/distributed-inference-network/issues/21-route-timeout-flag.md rename to docs/issues/21-route-timeout-flag.md diff --git a/.scratch/distributed-inference-network/issues/22-start-layer-protocol.md b/docs/issues/22-start-layer-protocol.md similarity index 100% rename from .scratch/distributed-inference-network/issues/22-start-layer-protocol.md rename to docs/issues/22-start-layer-protocol.md diff --git a/.scratch/distributed-inference-network/issues/23-heartbeat-stats.md b/docs/issues/23-heartbeat-stats.md similarity index 100% rename from .scratch/distributed-inference-network/issues/23-heartbeat-stats.md rename to docs/issues/23-heartbeat-stats.md diff --git a/.scratch/distributed-inference-network/issues/24-availability-map.md b/docs/issues/24-availability-map.md similarity index 100% rename from .scratch/distributed-inference-network/issues/24-availability-map.md rename to docs/issues/24-availability-map.md diff --git a/.scratch/distributed-inference-network/issues/25-rolling-rpm-stats.md b/docs/issues/25-rolling-rpm-stats.md similarity index 100% rename from .scratch/distributed-inference-network/issues/25-rolling-rpm-stats.md rename to docs/issues/25-rolling-rpm-stats.md diff --git a/.scratch/distributed-inference-network/issues/26-smart-model-assignment.md b/docs/issues/26-smart-model-assignment.md similarity index 100% rename from .scratch/distributed-inference-network/issues/26-smart-model-assignment.md rename to docs/issues/26-smart-model-assignment.md diff --git a/.scratch/distributed-inference-network/issues/27-throughput-routing.md b/docs/issues/27-throughput-routing.md similarity index 100% rename from .scratch/distributed-inference-network/issues/27-throughput-routing.md rename to docs/issues/27-throughput-routing.md diff --git a/.scratch/distributed-inference-network/issues/28-routing-correctness-tests.md b/docs/issues/28-routing-correctness-tests.md similarity index 100% rename from .scratch/distributed-inference-network/issues/28-routing-correctness-tests.md rename to docs/issues/28-routing-correctness-tests.md diff --git a/.scratch/distributed-inference-network/issues/29-relay-outbound-client.md b/docs/issues/29-relay-outbound-client.md similarity index 100% rename from .scratch/distributed-inference-network/issues/29-relay-outbound-client.md rename to docs/issues/29-relay-outbound-client.md diff --git a/.scratch/distributed-inference-network/prd.json b/docs/prd.json similarity index 100% rename from .scratch/distributed-inference-network/prd.json rename to docs/prd.json diff --git a/scripts/ralph_progress.py b/scripts/ralph_progress.py index cab5c33..0b2b586 100644 --- a/scripts/ralph_progress.py +++ b/scripts/ralph_progress.py @@ -33,7 +33,7 @@ from typing import Any REPO_ROOT = Path(__file__).resolve().parents[1] -DEFAULT_PRD = REPO_ROOT / ".scratch/distributed-inference-network/prd.json" +DEFAULT_PRD = REPO_ROOT / "docs/prd.json" DEFAULT_AGENT = "codex" DEFAULT_INTERVAL = 10.0 AGENT_CONFIG_PATH = REPO_ROOT / ".ralph-tui" / "agent-config.json"