<!--
IndexTitle: Plans Folder Guide
IndexDescription: How to use the Plans folder in the clean GetEstablished root, what belongs here, and how to navigate ~172 planning files.
IndexType: README
IndexStatus: Active
LastEdited: 2026-06-08
-->

# Plans Folder Guide

## Purpose

`Plans/` holds **project-specific** direction: backlog, maps, approved work not
yet implemented, migration reports, preserved prompts, reviews, and structured
decisions.

It is **not** the reusable agent workflow layer. That belongs in
`Capabilities/` and `Standards/`.

## Read First (agent boot)

After `AGENTS.md`, use these Plans files before searching the rest of the
folder:

| File | Role |
| --- | --- |
| [RepositorySearchMap.md](RepositorySearchMap.md) | Where to look, where to place new files, resume work |
| [AgentTaskBacklog.md](AgentTaskBacklog.md) | Ready Next, Later, Blocked, completed history |
| [RepositoryGoals.md](RepositoryGoals.md) | North-star outcomes |
| [FirstRunStreamlinePlan.md](FirstRunStreamlinePlan.md) | Beginner first session + packaging smoke test |
| [RepositoryImportPilotPlan.md](RepositoryImportPilotPlan.md) | Prompt-only archive import pilot (US1MoversArchive → US1Movers) |
| [RepositoryImportLessonsLearned.md](RepositoryImportLessonsLearned.md) | Pilot lessons; input to Import Capabilities v1 |
| [WebPresencePlatformSetPlan.md](WebPresencePlatformSetPlan.md) | Archetype platform Capability Set (Google, Yelp, Facebook) |
| [OpenQuestions.md](OpenQuestions.md) | Non-blocking owner decisions |
| [RepositoryMap.md](RepositoryMap.md) | Clean-root folder map (not a full file inventory) |
| [Roadmap.md](Roadmap.md) | Phased direction |
| [CloudOnlyPlanningAndMeasurementDevicePlan.md](CloudOnlyPlanningAndMeasurementDevicePlan.md) | Environment-adaptive operating model (Draft; partial impl on host) |
| [GEOTWSecondCoreReleaseReadiness.md](GEOTWSecondCoreReleaseReadiness.md) | Second GE→GEOTW release gates (defer until stable) |

**Operational reports (2026-06-07):**

| File | Role |
| --- | --- |
| [MigrationCompleteStatus.md](MigrationCompleteStatus.md) | Post-migration state; Indexes provisioned |
| [LazyScaffoldHostTighteningReport.md](LazyScaffoldHostTighteningReport.md) | Host scaffold policy; SharedWorkflow retired |
| [IntakeRetentionExecutionReport.md](IntakeRetentionExecutionReport.md) | Intake retention adopted |
| [CapabilityRoutingReview.md](CapabilityRoutingReview.md) | RouterIndex / routing posture |
| [RoutingTestSet.md](RoutingTestSet.md) | 27-case regression set |
| [GettingStartedDryRun.md](GettingStartedDryRun.md) | First-session validation (complete) |
| [Phase4PublishingPlatformDecision.md](Phase4PublishingPlatformDecision.md) | Phase 4 platform choice; build gates |
| [GitHubPagesHarmonyPlan.md](GitHubPagesHarmonyPlan.md) | Planned static mirror (not built) |

Plans normalization batches complete. [PlansFolderCleanupActivePlan.md](PlansFolderCleanupActivePlan.md) is **maintenance-only** — touch only when a Plans file regresses paths or boot order.

Batch 4 archive report: [PlansBatch4ArchiveReport.md](PlansBatch4ArchiveReport.md).
Archive link pass: [PlansBatch4ArchiveLinkPassReport.md](PlansBatch4ArchiveLinkPassReport.md).

## One-click worker launchers

**Migration complete 2026-06-03.** See `MigrationCompleteStatus.md`. Historical
copy and verification reports live in `Archive/MigrationReports/`. Implemented
plans from the migration era live in `Archive/SupersededPlans/`.

| Launcher | Use when |
| --- | --- |
| [RunWorkerPrompt_NextBacklogTask.md](RunWorkerPrompt_NextBacklogTask.md) | Run whatever is **Ready Next** in the backlog |
| [RunWorkerPrompt_PlansBatch2.md](RunWorkerPrompt_PlansBatch2.md) | Re-run Batch 2 path fixes or same scope |
| [RunWorkerPrompt_VerifyGitHubSync.md](RunWorkerPrompt_VerifyGitHubSync.md) | Verify local repo vs GitHub after commit/push |

In Cursor you can also type `@RunWorkerPrompt_NextBacklogTask` (or the Batch 2
file) to attach the launcher, then send **Run it**.

## Cursor recording (YouTube / demos)

| Guide | Use |
| --- | --- |
| [OneWindowCursorDemoScript.md](OneWindowCursorDemoScript.md) | 60-second Plan → Agent → Review script |
| [CursorYouTubeDemoGuide.md](CursorYouTubeDemoGuide.md) | Modes, paste-to-Agent, one vs two chats, episode outlines |

## What Belongs In Plans

| Belongs here | Does not belong here |
| --- | --- |
| Backlog, roadmap, open questions | Capability `Prompt.md` / `Rules.md` (use `Capabilities/`) |
| Migration and cleanup reports | Durable cross-repo rules (use `Standards/`) |
| Review-only pass findings (`*Review.md`) | Final website copy (use `Content/`) |
| Preserved prompts not yet promoted to Capabilities | Owner scratch notes (use `Workspace/`) |
| Structured plans (`*Plan.md`) | Historical Intake copies (use `Intake/`) |

## Folder Layout (this repository)

```text
Plans/
  README.md                          <- you are here
  RepositorySearchMap.md             <- search and placement (keep paths current)
  AgentTaskBacklog.md                <- task queue
  RepositoryMap.md                   <- structure map
  PlansFolderCleanupActivePlan.md    <- maintenance-only cleanup reference
  *Plan.md, *Review.md, *Prompt.md   <- mixed; see categories below
  Migration/                           <- optional; not required yet
```

Do not create `Plans/Migration/` or move files without an owner-approved
cleanup pass listed in the active cleanup plan.

## File Categories (navigation)

Most files fall into one of these groups. Use filename suffixes and the
**Status** line in each file header when unsure.

| Category | Examples | Typical action |
| --- | --- | --- |
| **Active direction** | `RepositoryGoals.md`, `Roadmap.md`, `AgentWorkflowModes.md`, `PlannerWorkerWorkflow.md` | Keep current; fix stale `Docs/` paths when touched |
| **Preserved prompts** | `*Prompt.md`, `AgentSelfDirectedLoop.md`, `RunWorkerPrompt_*.md` | Use as copy-ready workflow; promote to `Capabilities/` only with owner approval |
| **Reviews** | `*Review.md` | Historical evidence; archive later when superseded |
| **Plans (scoped)** | `*Plan.md`, `*CapabilityPlan.md` | Active until implemented or archived |
| **Migration reports** | `*CopyReport.md`, `*MigrationReport.md`, `CleanRoot*.md` | Keep until cleanup complete, then `Archive/` |
| **Deprecated workflow** | `CloudToLocal*.md` | Do not use for new work; see `Archive/` or deprecation notes in file |

For a full triage checklist, see
[PlansFolderCleanupActivePlan.md](PlansFolderCleanupActivePlan.md) and
[CleanRootVerificationAndCleanupPlan.md](CleanRootVerificationAndCleanupPlan.md).

## Stale Path Warning

Many Plans files still mention `Docs/Project`, `Docs/Capabilities`, or
`Docs/Prompts` from the **GetEstablishedOnTheWeb** layout. Those paths are wrong
in this repository.

**Trust order:**

1. Root `AGENTS.md` and this README
2. [RepositorySearchMap.md](RepositorySearchMap.md)
3. Live folders: `Capabilities/`, `Standards/`, `Plans/`, `Ideas/`, etc.
4. `Intake/GetEstablishedOnTheWeb/` — reference only, not a write destination

## Related Folders

| Folder | Relationship to Plans |
| --- | --- |
| `Ideas/` | Raw or tracked possibilities before they become Plans |
| `Capabilities/` | Repeatable workflows promoted from Plans or harmonized from other repos |
| `Archive/` | Retired Plans material after owner-approved moves |
| `Intake/GetEstablishedOnTheWeb/Plans/` | Source snapshot; do not edit unless Intake scope is approved |

## Placement Rules (quick)

- New **planning or review** markdown → `Plans/` unless the user names another path.
- New **reusable agent workflow** → `Capabilities/<Name>/` via **CapabilityCreate**.
- Repository root is **not** a default location for reports.

## Agent runtime (Cursor)

In **Cursor**, read and edit the local repo directly. **Do not mirror Plans
files to Google Drive** unless the user explicitly asks for ChatGPT review or a
refreshed reference mirror. Assisted GDrive/Dropbox workflows apply when
**ChatGPT** plans without repo access — see `Standards/AgentSituationalAwareness.md`.

Local canonical root: `C:\Repositories\GetEstablished`
