<!--
IndexTitle: Repository Instructions
IndexDescription: Agent rules for the Get Established Workspace consumer starter repository.
IndexType: Workflow
IndexStatus: Active
LastEdited: 2026-06-12
-->

# Repository Instructions

This is a **Get Established Workspace** — a consumer starter repository for the
owner's goals, ideas, and plans. It is **not** the GetEstablished archetype
development host.

Help the owner through **Quick Startup** → `Workspace/OwnerGoals.md`, then route
work through Capabilities. Read `Standards/AgentSituationalAwareness.md` before
acting.

## Quick Start

| Situation | What to do |
| --- | --- |
| First time in this repo | Say **"Begin Quick Startup from AGENTS.md"** — then follow full first-session order in `Capabilities/GettingStarted/GettingStarted.md` |
| GitHub web or mobile only (no local clone yet) | `Capabilities/GitHubWorkflow/CloudOnlyGitHubWorkflow.md` — capture Owner Goals in chat or PR; clone when ready |
| Returning with a task | Route via `Capabilities/RouterIndex.md` |
| Not sure what's going on | Read `Standards/AgentSituationalAwareness.md` |
| Want to capture an idea | Drop it in `Ideas/` |
| Ready to plan something | Move an idea into `Plans/` |

Before acting on any task: read this file, then `Standards/AgentSituationalAwareness.md`.

**Full Quick Startup session:** setup questions → Owner Goals → optional prior-repo
path note → valuable reference candidates → optional reference review → one routed
next task → park GitHub → soft indexing offer. See GettingStarted first-session order.

## Primary Goal Of Repository

This workspace helps the owner **capture Ideas**, turn selected Ideas into
**Plans**, and carry Plans through to **desired positive outcomes** — with
agents assisting in small, reviewable steps.

Formal chain: **Goals** → **Ideas** → **Plans** → implemented work.

**Outcomes follow Owner Goals.** Practical **online presence** (Get Established
On The Web) is one **supported outcome** when the owner wants it and shipped
Capabilities apply (GettingStarted, ContentReview, website drafts under
`Content/`). It is **not** the sole identity of every download unless
`Workspace/OwnerGoals.md` says so.

When summarizing this repo: lead with the **pipeline** (ideas → plans →
outcomes), then the owner's current goals. Web-oriented Capabilities may explain
why an agent mentions online presence — that is a supported outcome, not the
whole story.

## Starting Rule

Before making changes, read this file first.

The active local repository root is **this folder**:

```text
C:\Repositories\GetEstablishedStartup
```

Do not assume the root is `C:\Repositories\GetEstablished`. Use the workspace path the
owner opened.

When the owner references **`agents.md`**, read **`AGENTS.md`** at the repository
root (case-insensitive intent).

## Source Of Truth

| Rank | Surface | Role |
| --- | --- | --- |
| 1 | Local Git repository | Source of truth |
| 2 | GitHub | Backup and history |
| 3 | Dropbox or Google Drive | Optional review — **not connected to Git** |

**Cursor (repo open):** edit local Git only. **Default: no cloud copy** after edits.

## First 10 Minutes (Agent Startup)

On every new pass, before editing:

1. Read this file (`AGENTS.md`).
2. Read `Standards/AgentSituationalAwareness.md`.
3. If the owner said **Begin Quick Startup from AGENTS.md** (case-insensitive) or
   wants first setup → `Capabilities/GettingStarted/GettingStarted.md` — **not**
   an app launch; never use `/run` or server-start skills.
4. Otherwise route the task: read `Capabilities/RouterIndex.md` first, confirm in
   `Capabilities/AgentCapabilityGuide.md`, then the owning Capability's
   `Rules.md` and `Prompt.md`.
5. Confirm scope with the owner when unclear.
6. Edit **local Git only** unless cloud review sync was explicitly requested.

New human users: `README.md` → `Capabilities/GettingStarted/GettingStarted.md`.

## Active Workflow Signals

| Signal | Action |
| --- | --- |
| **Begin Quick Startup from AGENTS.md** (case-insensitive) | GettingStarted → OwnerGoals → ValuableReferences → soft indexing offer |
| GitHub web/mobile; no local clone yet | `GitHubWorkflow/CloudOnlyGitHubWorkflow.md` |
| First setup; owner goals | `Capabilities/GettingStarted/` |
| User pastes prior handoff; who has the ball? | `Capabilities/SituationalAwareness/Rules.md` section 2 |
| Git commit, push, branch | `Capabilities/GitHubWorkflow/` |
| Review public website drafts | `Capabilities/ContentReview/` |
| Repository folders; scaffold | `Capabilities/RepositoryScaffold/` |
| Save chat to markdown | `Capabilities/ChatToMarkdown/` |
| Index new files (default) | `Capabilities/ManualIndexing/` — no scripts |
| Install Cursor or local agent | `Capabilities/LocalAgentToolSetup/` |
| User names repository mirror refresh (Windows) | `Capabilities/MirrorToWindows/WorkflowIndex.md` |
| User names Google Drive review (connector, planner loop) | `Capabilities/GoogleDriveLink/WorkflowIndex.md` |

Avoid user phrase **`run Quick Startup`** — may trigger app-launch skills in Claude.

## Active Root Structure

| Folder | Role |
| --- | --- |
| `Capabilities/` | Repeatable workflows |
| `Standards/` | Durable rules |
| `Plans/` | Setup guides and planning |
| `Ideas/` | Captured possibilities |
| `Workspace/` | Owner goals and preferences |
| `Content/` | Publishable drafts |
| `Indexes/` | Pre-built navigation indexes |
| `Automation/` | IndexHealthCheck; `VerifyStarterPackage.ps1` (packaging re-check) |
| `Archive/` | Retired material |

## Capability Discovery (Starter Subset)

Map tasks through `Capabilities/RouterIndex.md`. This starter includes:

- `GettingStarted`, `RepositoryScaffold`, `GitHubWorkflow`, `ChatToMarkdown`
- `ContentReview`, `LocalAgentToolSetup`, `SituationalAwareness`
- `AssistedAgenticWorkflow`, `Indexing`, `ManualIndexing`
- `GoogleDriveLink` (optional cloud review — on demand only)
- `MirrorToWindows` (on-demand mirror refresh — docs-only on Windows)

**Manual indexing is the default.** Code-assisted indexing is not shipped in
this starter.

## Operating Rules

- Keep changes minimal and owner-approved.
- Do not commit or push unless the owner asks.
- Do not expand scope silently.
- End worker passes with one concise fenced `text` handoff when appropriate.

## Do Not Do List

- Do not treat cloud folders as Git remotes.
- Do not copy files to cloud on routine passes.
- Do not invent workflows when a Capability owns the task.
- Do not commit secrets or credentials.

## Agent Handoff

Worker handoff block fields when requested:

```text
Summary
Files Changed
Planning Files To Review
Questions Added Or Changed
Next Recommended Task
```

Post-download GitHub: `Capabilities/GitHubWorkflow/SetupPrompt.md`.
