<!-- Index: Official search map for agents that need repository orientation. -->
<!--
IndexTitle: Repository Search Map
IndexDescription: Stable boot and search map for the clean GetEstablished root.
IndexType: Project
IndexStatus: Active
LastEdited: 2026-06-07
-->

Official repository search map: `Plans/RepositorySearchMap.md`

# Repository Search Map

## Purpose

Stable boot map for ChatGPT, Codex, Cursor, and future agents when deciding:

- where to search first;
- where a new file belongs;
- which Capability owns a task;
- how to resume from a handoff.

This file is a map, not an index generator.

## Capability-First Routing

1. Read root `AGENTS.md`.
2. Use this map for placement and search.
3. Route workflow tasks through `Capabilities/README.md` and
   `Capabilities/AgentCapabilityGuide.md`.

Do not invent one-off workflow instructions when a Capability already owns the
area.

Preserved prompts in `Plans/` are **not** Capabilities until the owner promotes
them. See [Plans/README.md](README.md).

## If Repository Context Is Missing

Ask the user for the smallest useful artifact:

- `RepositoryTree.txt`
- A targeted `tree` or `Get-ChildItem` output
- A specific file path from this map

**Cursor:** read files in the open workspace. Do not copy to cloud on each
pass. Do not use cloud Capability workflow indexes for routine work.

**ChatGPT planner (no local repo access):** read from a cloud review copy
**only if the owner has copied files there** for review. Boot from
`Capabilities/DropboxLink/WorkflowIndex.md` or
`Capabilities/GoogleDriveLink/WorkflowIndex.md` when using that stack. Do not
ask the user to paste files or send a worker pass only to inspect files when
a current cloud copy or handoff is available.

See `Standards/AgentSituationalAwareness.md`.

## Cloud Handoff Notes

When the user says to pick up from the last chat, read a cloud handoff note if
present (pointer only). Then boot from the **local clean root** when available:

1. `AGENTS.md`
2. `Plans/RepositorySearchMap.md`
3. `Plans/AgentTaskBacklog.md`
4. Task-specific files named in the note or backlog

Confirm the current **Ready Next** task before implementing.

Keep cloud handoff notes compact. Durable rules live in `AGENTS.md`,
`Capabilities/`, `Standards/`, and `Plans/` — not in the cloud note body.

## First Search Path

```text
AGENTS.md
Standards/AgentSituationalAwareness.md
README.md
Plans/RepositorySearchMap.md
Plans/RepositoryMap.md
Plans/AgentTaskBacklog.md
Indexes/README.md
Capabilities/AgentCapabilityGuide.md
(task-specific Capability or Plans file)
```

## Search Guidance

| Need | Look first | Then check |
| --- | --- | --- |
| Cursor vs ChatGPT / assisted workflow | `Standards/AgentSituationalAwareness.md` | `Capabilities/DropboxLink/WorkflowIndex.md`, `Capabilities/GoogleDriveLink/WorkflowIndex.md` |
| Capability metadata / harmonization | `Standards/CapabilityMetadataStandard.md` | `Capabilities/README.md` |
| Cursor demo / YouTube recording | `Plans/OneWindowCursorDemoScript.md` | `Plans/CursorYouTubeDemoGuide.md` |
| Repository identity / formal terms | `Plans/RepositoryGoals.md` | `Plans/GoalsIdeasPlansCapabilitiesModel.md` |
| Owner Goals register | `Workspace/OwnerGoals.md` | `Capabilities/GettingStarted/` |
| Idea register | `Plans/Ideas.md` | `Ideas/`, `Ideas/FutureIdeas.md`, `Standards/IdeaCaptureTemplate.md` |
| Capture chat to durable artifacts | `Capabilities/InstructionCapture/Prompt.md` | `Standards/PromotionChecklist.md`, `Capabilities/ChatToMarkdown/` |
| Audit catalog or repository readiness | `Capabilities/CapabilityAudit/AuditChecklist.md` | `StalePlanDetection.md`, `AuditReportTemplate.md` |
| New planning file scaffold | `Standards/PlanTemplate.md` | `Plans/GoalsIdeasPlansCapabilitiesModel.md` |
| Promotion / archive policy | `Standards/PromotionChecklist.md` | `Standards/ArchiveAndDeprecationRules.md` |
| Cross-repo Capability compare / blend | `Capabilities/CapabilityHarmonize/README.md` | `Standards/RepositoryArchetypeAndCapabilityTiers.md` |
| Index refresh | `Capabilities/Indexing/README.md` | `Standards/MarkdownIndexMetadataStandard.md` |
| Index health check | `Capabilities/Indexing/IndexHealthCheck.md` | `Standards/IndexHealthStandard.md`, `Automation/IndexHealthCheck/Run-IndexHealthCheck.ps1` |
| Index workflow (Setup → check → refresh) | `Capabilities/Indexing/WorkflowIndex.md` | `Capabilities/Indexing/SetupPrompt.md`, `Prompt.md` |
| Chat / agent file lookup | `Indexes/ChatMarkdownIndex.md` | `Indexes/README.md` |
| Follow-through queue | `Indexes/FollowThroughIndex.md` | `Plans/AgentTaskBacklog.md` |
| Routing regression | `Plans/RoutingTestSet.md` | `Plans/CapabilityRoutingReview.md` |
| Routing parity audit (C1) | `Plans/RoutingParityAuditReport.md` | `Capabilities/CapabilityAudit/AuditChecklist.md` |
| Intake retention / scaffold policy | `Plans/IntakeRetentionExecutionReport.md` | `Plans/LazyScaffoldHostTighteningReport.md`, `Intake/README.md` |
| Current work queue | `Plans/AgentTaskBacklog.md` | `Plans/RunWorkerPrompt_NextBacklogTask.md` |
| Resume agent work | `Plans/AgentTaskBacklog.md` | `Plans/AgentWorkflowModes.md`, `Plans/PlannerWorkerWorkflow.md` |
| Open decisions | `Plans/OpenQuestions.md` | Related `Plans/*Plan.md` |
| Plans folder orientation | `Plans/README.md` | `Plans/PlansFolderCleanupActivePlan.md` |
| Clean-root cleanup status | `Plans/CleanRootVerificationAndCleanupPlan.md` | `Plans/PlansFolderCleanupActivePlan.md` |
| Structure / migration history | `Plans/RepositoryStructureHarmonizationPlan-Temporary.md` | `Plans/StructureReferenceAuditReport.md` |
| Project naming alignment | `Plans/ProjectRepositoryAlignmentPlan.md` | `Plans/CleanRootMappingDecisionReport.md` |
| Capabilities | `Capabilities/AgentCapabilityGuide.md` | `Capabilities/README.md` |
| Capability creation | `Capabilities/CapabilityCreate/README.md` | `Capabilities/CapabilityCreate/Rules.md` |
| Skills | `Capabilities/SkillRegistry.md` | Owning `Capabilities/<Name>/` |
| Standards | `Standards/README.md` | `Standards/RepositoryCoreStandard.md` |
| Website content (canonical) | `GetEstablishedOnTheWeb/Content/Website/Pages/` | `Content/Website/README.md` (host pointer) |
| One-page business website | `Content/OnePageBusinessWebsite/README.md` | `Capabilities/OnePageWebsite/` |
| Mobile capture | `Capabilities/ChatMemoryCapture/MobileIdeaCaptureWorkflow.md` | `Capabilities/OneDriveLink/README.md` |
| Environment-adaptive operating model | `Plans/CloudOnlyPlanningAndMeasurementDevicePlan.md` | `GEOTWSecondCoreReleaseReadiness.md` (release gates); `Standards/NamingStandard.md` §Environment-Adaptive Model |
| Owner environment | `Workspace/OwnerPreferences.md` Environment section | `Capabilities/SituationalAwareness/EnvironmentDetectionQuestions.md` |
| Cloud review (on demand only) | `Capabilities/DropboxLink/WorkflowIndex.md` | `Capabilities/GoogleDriveLink/WorkflowIndex.md` |
| GitHub workflow | `Capabilities/GitHubWorkflow/README.md` | `Capabilities/GitHubWorkflow/BeginnerGitHubOnboarding.md` |
| Chat to Markdown | `Capabilities/ChatToMarkdown/README.md` | `Capabilities/ChatToMarkdown/Rules.md` |
| Instruction capture / triage | `Capabilities/InstructionCapture/README.md` | `Standards/PromotionChecklist.md` |
| Migration complete / history | `Plans/MigrationCompleteStatus.md` | `Archive/MigrationReports/README.md` |
| Phase 4 publishing platform | `Plans/Phase4PublishingPlatformDecision.md` (stub → GEOTW) | `GetEstablishedOnTheWeb/Plans/` |
| GEOTW core release | `Plans/GEOTWCoreReleaseWorkflow.md` | `GetEstablishedOnTheWeb/Plans/` |
| Historical reviews | `Archive/HistoricalReviews/` | Dated filename matching the topic |

## Placement Hints

| Information type | Active location |
| --- | --- |
| Reusable workflow prompts and rules | `Capabilities/<CapabilityName>/` |
| Project plans, reviews, backlog, maps | `Plans/` |
| Durable conventions | `Standards/` |
| Tracked ideas | `Plans/Ideas.md` | `Ideas/`, `Ideas/FutureIdeas.md` |
| Owner Goals | `Workspace/OwnerGoals.md` | `Capabilities/GettingStarted/` |
| Publishable content | `Content/` |
| Owner drafts and private notes | `Workspace/` |
| Scripts and repeatable tools | `Automation/` |
| Retired material | `Archive/` |
| Legacy source snapshot | `Intake/GetEstablishedOnTheWeb/` (read-only) |

## Capability Shortcuts

| User asks about | Capability |
| --- | --- |
| First setup, Owner Goals, Quick Startup | `GettingStarted` |
| Google Drive, Drive MCP, handoff | `GoogleDriveLink` |
| Dropbox, ChatGPT + Codex review | `DropboxLink` |
| OneDrive, phone capture (planning) | `OneDriveLink` |
| Git status, pull, push, GitHub setup | `GitHubWorkflow` |
| Save chat to Markdown | `ChatToMarkdown` |
| Website draft review | `ContentReview` |
| Local agent app setup (Cursor, etc.) | `LocalAgentToolSetup` |
| Create a new Capability | `CapabilityCreate` |
| GitHub web/mobile; no local clone yet | `GitHubWorkflow` → `CloudOnlyGitHubWorkflow.md` |
| Refresh indexes | `ManualIndexing` (default) or `Indexing` → `WorkflowIndex.md` |
| Index health check | `Indexing` → `IndexHealthCheck.md` or `Automation/IndexHealthCheck/` |
| Add folders when content exists | `RepositoryScaffold` |

## Search Commands (when the agent cannot see files)

```powershell
Get-ChildItem Capabilities
```

```powershell
Get-Content Plans\RepositorySearchMap.md
```

```powershell
Get-Content Capabilities\AgentCapabilityGuide.md
```

```powershell
Get-Content Plans\AgentTaskBacklog.md -Head 40
```

## Intake Boundary

`Intake/GetEstablishedOnTheWeb/` preserves the old `Docs/` tree for reference.
If a Plans file points at `Docs/Project` or `Docs/Capabilities`, translate to
the clean-root paths in this map — do not create new files under `Docs/` in
the active repository.
