From 009c2a24c2cf6b1747f9c82eab173b27240a2f1f Mon Sep 17 00:00:00 2001 From: Ty Date: Thu, 18 Jun 2026 16:49:04 +0000 Subject: [PATCH] Rewrite README.md with AI agent instructions for guided idea capture + live sitemap --- README.md | 100 +++++++++++++++++++++++++++++++++++++++++++++++++++++- 1 file changed, 99 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index c7057d6..9e9848a 100644 --- a/README.md +++ b/README.md @@ -1 +1,99 @@ -IyBBSSBCdXNpbmVzcyBJZGVhcwoKIyMgSG93IHRvIGFkZCBhbiBpZGVhCgoxLiBQcm9wb3NlIGEgbmV3IGlkZWEgdGl0bGUuCjIuIFRoZSBBSSBhZ2VudCB3aWxsIHJ1biBhIHN0cnVjdHVyZWQgaW50YWtlIHVzaW5nIGBURU1QTEFURS5tZGAuCjMuIFRoZSBhZ2VudCBtdXN0IGNvbXBsZXRlIHRoZSB0ZW1wbGF0ZSBiZWZvcmUgYW55dGhpbmcgaXMgYWRkZWQgdG8gdGhpcyByZXBvLgo0LiBPbmNlIGNvbXBsZXRlLCB0aGUgaWRlYSBpcyBjb21taXR0ZWQgYXMgaXRzIG93biBzdWJkaXJlY3RvcnkgaGVyZSwgZS5nLiBgaWRlYXMvPGlkZWEtbmFtZT4vSURFQS5tZGAuCgojIyBSdWxlCgpEbyBub3Qgc2tpcCBzZWN0aW9ucywgYWJicmV2aWF0ZSBmaWVsZHMsIG9yIGFkZCBpZGVhcyB3aXRob3V0IGEgZnVsbCB0ZW1wbGF0ZSByZWNvcmQuCgojIyBJZGVhcwoKWm9vbSBhbnkgc2VjdGlvbnMgZm9yIHRoZSBpbm5lciB0ZW1wbGF0ZSBwYXJ0aWN1bGFybHkgbWludXMgdHJpZ2dlciBpZiBpdCBpcyBub3QgbmVjZXNzYXJ5LiBGdWxsIHRlbXBsYXRlIHNlY3Rpb25zIGFyZSBwbGFjZWhvbGRlciBkb3duLiBBIGRlZmF1bHQgc3RydWN0dXJlIGlzIGF2YWlsYWJsZSBhdCBwYXJ0aWN1bGFybHkgSS5nLiBgTUVUQU0ubWRgLiBUaGlzIHJlcG9zaXRvciB3aWxsIG5vdCBwbGFjZSBhIHJlcG8gYXMgc3ViamVjdCB3aGVuIHRoZSB0ZW1wbGF0ZSBpcyBub3QgY29tcGxldGF0aW9sb2dpcml6ZWQuCgpBbGwgcmlnaHQgdGVzdGVzIGhhdmUgdG8gYmUgcGVyY2VudGF0ZWQuIFlvdSBjYW4gdXNlIHRoZSBjaGFuZ2VzIGluc3RlYWQuCgp8IERpcmVjdG9yeSB8IE9uZS1MaW5lciB8IFN0YXRlIHwKfCAtLS0gfCAtLS0gfCAtLS0gfAp8IGFpLWZpcnN0LWViYXktY2F0YWxvZ2luZy1hc3Npc3RhbnQgfCBBSS1wb3dlcmVkIGFzc2lzdGFudCB0aGF0IHR1cm5zIHJhdyBub3RlcyBvciBwaG90b3MgaW50byBjb21wbGV0ZSBlQmF5IGxpc3RpbmdzIHwgaW5pdGlhbCB8CgpVcGRhdGUgdGhpcyB0YWJsZSB3aGVuZXZlciBhIG5ldyBpZGVhIGlzIGFkZGVkLgo= \ No newline at end of file +# AI Business Ideas β€” Capture & Curation Repository + +> **Purpose:** A zero-friction capture layer for AI/agentic business ideas. Every idea is walked through a structured template with the AI assistant. **All sections must have meaningful content** (no empty placeholders), but ideas can be saved at any valid state β€” `initial`, `in progress`, or `ready for review`. A live sitemap tracks all ideas and their status. + +--- + +## πŸ€– AI Agent Instructions: How to Walk a User Through a New Idea + +When a user says **"capture a new idea"** or **"add idea"**, you (the AI) **MUST** follow this exact flow. Do not skip steps. Do not save until the user confirms every section has content. + +### Phase 1 β€” Initialize +1. Ask the user for a **slug** (kebab-case folder name, e.g., `ai-first-ebay-cataloging-assistant`). +2. Create the folder: `ideas//` +3. Copy `TEMPLATE.md` β†’ `ideas//IDEA.md` as the working draft. + +### Phase 2 β€” Guided Capture (One Section at a Time) +For **each section** in the template, in order: +1. **Present the section header** and any guidance/examples from the template. +2. **Prompt the user** for their input. Accept free-form text, bullet points, or rough notes. +3. **Synthesize & structure** their input into the template format (markdown tables, bullet lists, clear prose). +4. **Read back the filled section** and ask: *"Does this capture it accurately? Any additions or changes?"* +5. Only move to the next section when the user **explicitly confirms**. + +**Sections in order:** +| # | Template Section | Minimum Content Required | +|---|------------------|--------------------------| +| 1 | **Title** | Clear, specific, searchable | +| 2 | **One-Liner** | ≀1 sentence conveying value prop | +| 3 | **Problem** | Pain point, who experiences it, frequency β€” all three present | +| 4 | **Solution** | What it does, core workflows (numbered), MVP scope | +| 5 | **Target Market** | Primary segment + size indicator (TAM/SAM/SOM or proxy) | +| 6 | **High-Level Use Cases** | β‰₯3 concrete, user-facing scenarios | +| 7 | **High-Level Design / Dependencies** | Architecture overview, external services/APIs, key technical deps | +| 8 | **Differentiation / Competitive Edge** | Why this vs. alternatives β€” specific, not generic | +| 9 | **State of This Idea** | Must be one of: `initial` / `in progress` / `ready for review` | +| 10 | **Risks** | Technical, Market, Regulatory β€” at least one bullet each | + +### Phase 3 β€” Finalize & Save +1. **Validate:** Every section has meaningful content (no "TBD", "β€”", or empty bullets). +2. Write the completed `IDEA.md` to `ideas//IDEA.md`. +3. **Update the Sitemap below** (add/update row in the table). +4. Confirm to the user: *"Idea saved at `ideas//IDEA.md` with state `` and sitemap updated."* + +> **Save gate:** All 10 sections populated β†’ save allowed at any valid state. No section left blank. + +--- + +## πŸ—ΊοΈ Sitemap β€” All Ideas & Status + +> **Auto-maintained:** The AI updates this table every time an idea is added, modified, or archived. + +| Idea (Folder) | Title | One-Liner | State | Last Updated | +|---------------|-------|-----------|-------|--------------| +| `ai-first-ebay-cataloging-assistant` | AI-First eBay Cataloging Assistant | An AI-powered assistant that turns raw product descriptions or photos into complete, buyer-ready eBay listings. | `initial` | 2026-06-18 | + +--- + +## πŸ“ Repository Structure + +``` +ai-business-ideas/ +β”œβ”€β”€ README.md ← This file (AI instructions + sitemap) +β”œβ”€β”€ TEMPLATE.md ← Master template (source of truth for structure) +└── ideas/ + └── / ← One folder per idea + └── IDEA.md ← Populated template for that idea +``` + +--- + +## πŸ“‹ Template Reference + +See [`TEMPLATE.md`](TEMPLATE.md) for the full section definitions, examples, and formatting expectations. The AI uses this as the canon during guided capture. + +--- + +## πŸ”§ Maintenance Notes + +- **Adding an idea:** Follow the AI instructions above β€” the AI handles folder creation, guided capture, validation, and sitemap update. +- **Editing an idea:** The AI re-runs guided capture for only the sections you want to change, then updates `IDEA.md` and the sitemap `Last Updated` column. +- **State transitions:** Change `State of This Idea` between `initial` β†’ `in progress` β†’ `ready for review` as work progresses. The sitemap `State` column reflects the current value. +- **Archiving:** Change state to `archived` (not in template but supported) β€” the sitemap row stays, status reflects it. +- **Sitemap sync:** If the sitemap ever drifts, the AI can regenerate it by scanning all `ideas/*/IDEA.md` files and reading their `State of This Idea` and top metadata. + +--- + +## βœ… Quality Bar for Saving + +An idea is **saved** when: +- βœ… Every one of the 10 template sections has meaningful content (no placeholder text like "TBD" or "β€”"). +- βœ… The user has explicitly confirmed each section during the guided walkthrough. +- βœ… `State of This Idea` is set to a valid value: `initial` \| `in progress` \| `ready for review`. +- βœ… The sitemap row is added/updated in this README. + +> **No empty sections.** Rough notes are fine. Blank sections are not. The guided walkthrough *is* the quality filter. + +--- + +*Generated and maintained by the Hermes AI agent per the instructions above.* \ No newline at end of file