@hanzlaa/rcode 4.3.3 → 4.4.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (118) hide show
  1. package/CONTRIBUTING.md +1 -1
  2. package/README.md +28 -5
  3. package/cli/doctor.js +21 -3
  4. package/cli/generate-command-skills.cjs +1 -1
  5. package/cli/index.js +5 -1
  6. package/cli/install.js +7 -9
  7. package/cli/postinstall.js +22 -2
  8. package/cli/uninstall.js +48 -6
  9. package/dist/rcode.js +202 -203
  10. package/package.json +13 -23
  11. package/rcode/agents/rcode-codebase-mapper.md +12 -0
  12. package/rcode/agents/rcode-phase-researcher.md +13 -0
  13. package/rcode/agents/rcode-project-researcher.md +32 -0
  14. package/rcode/agents/rcode-roadmapper.md +15 -0
  15. package/rcode/agents/rules/planner/common-patterns.md +40 -0
  16. package/rcode/bin/lib/roadmap.cjs +184 -11
  17. package/rcode/bin/rcode-hooks.cjs +102 -151
  18. package/rcode/bin/rcode-tools.cjs +669 -55
  19. package/rcode/commands/lazy.md +10 -0
  20. package/rcode/data/intent-table.json +87 -0
  21. package/rcode/modules/seo.yaml +22 -0
  22. package/rcode/references/project-types.yaml +75 -0
  23. package/rcode/references/verb-dictionary.md +1 -1
  24. package/rcode/skills/SKILLS_INDEX.md +18 -1
  25. package/rcode/skills/actions/1-analysis/rcode-prfaq/SKILL.md +1 -1
  26. package/rcode/skills/actions/4-implementation/rcode-herdr-orchestration/SKILL.md +4 -21
  27. package/rcode/skills/actions/4-implementation/rcode-herdr-orchestration/templates/heartbeat.sh +0 -0
  28. package/rcode/skills/actions/4-implementation/rcode-scaffold-project/SKILL.md +60 -1
  29. package/rcode/skills/core/rcode-init/scripts/__pycache__/rcode_init.cpython-38.pyc +0 -0
  30. package/rcode/skills/core/rcode-init/scripts/tests/__pycache__/test_rcode_init.cpython-38.pyc +0 -0
  31. package/rcode/skills/seo/module.yaml +20 -0
  32. package/rcode/skills/seo/on-page-seo-auditor/SKILL.md +308 -0
  33. package/rcode/skills/seo/on-page-seo-auditor/references/audit-example.md +109 -0
  34. package/rcode/skills/seo/on-page-seo-auditor/references/audit-templates.md +427 -0
  35. package/rcode/skills/seo/on-page-seo-auditor/references/bulk-audit-playbook.md +116 -0
  36. package/rcode/skills/seo/on-page-seo-auditor/references/scoring-rubric.md +525 -0
  37. package/rcode/skills/seo/rank-and-rent-local-seo/SKILL.md +94 -0
  38. package/rcode/skills/seo/rank-and-rent-local-seo/rules/city-matrix-and-pages.md +76 -0
  39. package/rcode/skills/seo/rank-and-rent-local-seo/rules/monetization.md +70 -0
  40. package/rcode/skills/seo/rank-and-rent-local-seo/rules/niche-selection.md +60 -0
  41. package/rcode/skills/seo/rank-and-rent-local-seo/rules/subniche-discovery.md +66 -0
  42. package/rcode/skills/seo/rank-and-rent-local-seo/templates/service-city-page.md +36 -0
  43. package/rcode/skills/seo/rank-and-rent-local-seo/templates/subniche-research-prompt.md +34 -0
  44. package/rcode/skills/seo/seo-audit/SKILL.md +412 -0
  45. package/rcode/skills/seo/seo-audit/evals/evals.json +136 -0
  46. package/rcode/skills/seo/seo-audit/references/ai-writing-detection.md +200 -0
  47. package/rcode/skills/seo/seo-content-factory/SKILL.md +130 -0
  48. package/rcode/skills/seo/seo-content-factory/rules/agents.md +80 -0
  49. package/rcode/skills/seo/seo-content-factory/rules/herdr-wave-mapping.md +80 -0
  50. package/rcode/skills/seo/seo-content-factory/rules/pipeline.md +102 -0
  51. package/rcode/skills/seo/seo-content-factory/rules/programmatic-pages.md +107 -0
  52. package/rcode/skills/seo/seo-content-factory/rules/quality-gates.md +68 -0
  53. package/rcode/skills/seo/seo-content-factory/rules/weekly-cadence.md +61 -0
  54. package/rcode/skills/seo/seo-content-factory/templates/BACKLOG.md +23 -0
  55. package/rcode/skills/seo/seo-content-factory/templates/agent-prompts/01-funnel-A1-A4.md +63 -0
  56. package/rcode/skills/seo/seo-content-factory/templates/agent-prompts/02-fanout-editorial-A5-A6-A8.md +28 -0
  57. package/rcode/skills/seo/seo-content-factory/templates/agent-prompts/03-fanout-programmatic-A7-A6-A8.md +25 -0
  58. package/rcode/skills/seo/seo-content-factory/templates/agent-prompts/04-loop-A9-A10.md +34 -0
  59. package/rcode/skills/seo/seo-content-factory/templates/article.mdx +39 -0
  60. package/rcode/skills/seo/seo-content-factory/templates/cluster.schema.json +52 -0
  61. package/rcode/skills/seo/seo-content-factory/templates/content-brief.md +51 -0
  62. package/rcode/skills/seo/seo-content-factory/templates/jsonld-builders.ts +49 -0
  63. package/rcode/skills/seo/seo-content-factory/templates/keywords.csv +13 -0
  64. package/rcode/skills/seo/seo-content-factory/templates/programmatic-page.tsx +58 -0
  65. package/rcode/skills/seo/seo-content-writer/SKILL.md +263 -0
  66. package/rcode/skills/seo/seo-content-writer/references/content-structure-templates.md +875 -0
  67. package/rcode/skills/seo/seo-content-writer/references/instructions-detail.md +239 -0
  68. package/rcode/skills/seo/seo-content-writer/references/seo-writing-checklist.md +250 -0
  69. package/rcode/skills/seo/seo-content-writer/references/title-formulas.md +339 -0
  70. package/rcode/skills/seo/seo-growth-orchestrator/SKILL.md +79 -0
  71. package/rcode/skills/seo/seo-growth-orchestrator/rules/backlinks.md +29 -0
  72. package/rcode/skills/seo/seo-growth-orchestrator/rules/content-engine.md +27 -0
  73. package/rcode/skills/seo/seo-growth-orchestrator/rules/dos-and-donts.md +40 -0
  74. package/rcode/skills/seo/seo-growth-orchestrator/rules/goals-protocol.md +34 -0
  75. package/rcode/skills/seo/seo-growth-orchestrator/rules/local-seo-stack.md +35 -0
  76. package/rcode/skills/seo/seo-growth-orchestrator/rules/mrr-sprint.md +27 -0
  77. package/rcode/skills/seo/seo-growth-orchestrator/rules/tools.md +19 -0
  78. package/rcode/skills/seo/seo-growth-orchestrator/templates/backlink-research.md +29 -0
  79. package/rcode/skills/seo/seo-growth-orchestrator/templates/goal-protocol.md +35 -0
  80. package/rcode/skills/seo/seo-growth-orchestrator/templates/local-citations.md +24 -0
  81. package/rcode/skills/seo/seo-growth-orchestrator/templates/local-city-pages.md +27 -0
  82. package/rcode/skills/seo/seo-growth-orchestrator/templates/local-gbp-categories.md +23 -0
  83. package/rcode/skills/seo/seo-growth-orchestrator/templates/local-gsc-goldmine.md +27 -0
  84. package/rcode/skills/seo/seo-growth-orchestrator/templates/local-review-mining.md +26 -0
  85. package/rcode/skills/seo/seo-growth-orchestrator/templates/mrr-30day-plan.md +19 -0
  86. package/rcode/skills/seo/seo-growth-orchestrator/templates/mrr-cut.md +13 -0
  87. package/rcode/skills/seo/seo-growth-orchestrator/templates/mrr-opportunity-finder.md +17 -0
  88. package/rcode/skills/seo/seo-growth-orchestrator/templates/mrr-role-model.md +18 -0
  89. package/rcode/skills/seo/seo-site-builder/SKILL.md +149 -0
  90. package/rcode/skills/seo/seo-site-builder/rules/01-niche-discovery.md +64 -0
  91. package/rcode/skills/seo/seo-site-builder/rules/02-deep-research.md +164 -0
  92. package/rcode/skills/seo/seo-site-builder/rules/03-keyword-strategy.md +82 -0
  93. package/rcode/skills/seo/seo-site-builder/rules/04-content-plan.md +173 -0
  94. package/rcode/skills/seo/seo-site-builder/rules/05-site-build.md +187 -0
  95. package/rcode/skills/seo/seo-site-builder/rules/06-yolo.md +127 -0
  96. package/rcode/skills/seo/seo-site-builder/templates/article-stub.mdx +62 -0
  97. package/rcode/skills/seo/seo-site-builder/templates/image-prompt.md +97 -0
  98. package/rcode/skills/seo/seo-site-builder/templates/keyword-export.md +45 -0
  99. package/rcode/skills/seo/seo-site-builder/templates/niche-scorecard.md +28 -0
  100. package/rcode/skills/seo/technical-seo-checker/SKILL.md +329 -0
  101. package/rcode/skills/seo/technical-seo-checker/references/bulk-audit-playbook.md +118 -0
  102. package/rcode/skills/seo/technical-seo-checker/references/ecommerce-platform-patterns.md +166 -0
  103. package/rcode/skills/seo/technical-seo-checker/references/http-status-codes.md +705 -0
  104. package/rcode/skills/seo/technical-seo-checker/references/llm-crawler-handling.md +257 -0
  105. package/rcode/skills/seo/technical-seo-checker/references/pre-migration-playbook.md +137 -0
  106. package/rcode/skills/seo/technical-seo-checker/references/robots-txt-reference.md +717 -0
  107. package/rcode/skills/seo/technical-seo-checker/references/technical-audit-example.md +169 -0
  108. package/rcode/skills/seo/technical-seo-checker/references/technical-audit-templates.md +436 -0
  109. package/rcode/templates/settings-hooks.json +4 -0
  110. package/rcode/workflows/do.md +16 -0
  111. package/rcode/workflows/execute-sprint.md +22 -0
  112. package/rcode/workflows/execute.md +17 -3
  113. package/rcode/workflows/help.md +0 -2
  114. package/rcode/workflows/new-milestone.md +21 -9
  115. package/rcode/workflows/new-project-create-roadmap.md +2 -0
  116. package/rcode/workflows/new-project-roadmap.md +2 -0
  117. package/rcode/workflows/new-project.md +3 -0
  118. package/rcode/workflows/plan.md +15 -2
@@ -0,0 +1,29 @@
1
+ # Backlink research workflow (guest-post finder + competitor mining)
2
+
3
+ Fill `{{site_url}}` and `{{niche}}`. Connect Ahrefs API for accuracy; otherwise keep the "score natively" line.
4
+
5
+ ```
6
+ You are a backlink acquisition strategist. Target site: {{site_url}} (niche: {{niche}}).
7
+ First ask clarifying questions until you are ≥95% confident, then run BOTH workflows.
8
+
9
+ [If no Ahrefs API: "Do not use any Ahrefs/SEMrush API. Do your own analysis and score
10
+ opportunities natively (0–100), and label every score as an estimate."]
11
+
12
+ WORKFLOW A — Guest-post finder:
13
+ Find sites in this niche that accept guest posts / contributor content. For each, output:
14
+ site name, guest-post or contact URL, quality score 0–100 (site structure, blog activity,
15
+ social presence, topical relevance), and a one-line "why it fits".
16
+ Rank high→low. Produce a markdown table AND a CSV block.
17
+ (If a Gmail connector is available: also DRAFT — do not send — a short personalized
18
+ outreach email per opportunity.)
19
+
20
+ WORKFLOW B — Competitor backlink mining:
21
+ Identify my top 3–5 competitors for this niche. For each, list where they earn backlinks.
22
+ Surface the highest-authority, most replicable opportunities I could also obtain. Output:
23
+ source domain, which competitor it links to, DR/authority (or estimate), replicability
24
+ score 0–100, ranked high→low, as a markdown table AND CSV block.
25
+
26
+ Finish with a "Get these 10 first" shortlist across both workflows, ordered by ROI.
27
+ ```
28
+
29
+ Re-run every 2–4 weeks. Pair with the optional backlink-exchange (see `rules/tools.md`).
@@ -0,0 +1,35 @@
1
+ # /goal — Goals Protocol template
2
+
3
+ Start the message in Claude with `/goal` so it runs the worker→evaluator loop, then paste:
4
+
5
+ ```
6
+ GOAL: {{one sentence, action verb first, ONE deliverable}}
7
+
8
+ OUTPUT SPEC:
9
+ - File: {{exact filename}}
10
+ - Format: {{e.g. CSV / markdown table}}
11
+ - Columns/Schema: {{exact columns or structure}}
12
+
13
+ ACCEPTANCE CRITERIA (each yes/no or a number):
14
+ 1. {{criterion}}
15
+ 2. {{criterion}}
16
+ 3. {{criterion}}
17
+
18
+ LIMITS / CONSTRAINTS (what NOT to do):
19
+ - {{forbidden action / scope wall / cap}}
20
+ - {{...}}
21
+
22
+ STOP AND VERIFY:
23
+ Before declaring complete, list each acceptance criterion with the evidence that
24
+ satisfies it, then hand the deliverable to the evaluator for an independent audit.
25
+
26
+ First, ask me clarifying questions one at a time until you are ≥95% confident,
27
+ then proceed.
28
+ ```
29
+
30
+ Quality gate before running — must pass all three:
31
+ - Stranger test: a stranger knows exactly what "done" is.
32
+ - Spreadsheet test: every criterion fits a yes/no or number column.
33
+ - Runway test: constraints catch the worst misinterpretation within minutes.
34
+
35
+ One goal per run. If you have several, sequence them.
@@ -0,0 +1,24 @@
1
+ # Local citation audit + directory cleanup
2
+
3
+ Fill `{{business_name}}`, `{{address}}`, `{{phone}}`, `{{website}}`, `{{industry}}`.
4
+
5
+ ```
6
+ You are a local SEO citation auditor.
7
+ Canonical NAP:
8
+ - Name: {{business_name}}
9
+ - Address: {{address}}
10
+ - Phone: {{phone}}
11
+ - Website: {{website}}
12
+ - Industry: {{industry}}
13
+
14
+ 1. Find everywhere this business is listed (general + industry directories such as
15
+ Thumbtack, Angi, HomeAdvisor, Yelp, BBB, and industry-specific ones).
16
+ 2. Flag every NAP inconsistency — including abbreviations ("Ste" vs "Suite"),
17
+ formatting, old phone numbers, name variants.
18
+ 3. Output HIGH-PRIORITY FIXES: the listing, what's wrong, the exact corrected value,
19
+ and where/how to fix it.
20
+ 4. Output MISSING HIGH-VALUE LISTINGS for this industry that I should claim
21
+ (easy authority + backlink wins), ranked by value.
22
+
23
+ Constraint: the corrected NAP must be byte-identical everywhere.
24
+ ```
@@ -0,0 +1,27 @@
1
+ # Service + city landing page builder
2
+
3
+ Fill `{{business_url}}` and `{{primary_city}}`.
4
+
5
+ ```
6
+ You are a local SEO page architect for: {{business_url}} (primary area: {{primary_city}}).
7
+ First ask clarifying questions until ≥95% confident.
8
+
9
+ Phase 1 — Site audit + gap map:
10
+ List every service currently on the site and its dedicated page (or "none"). Build a
11
+ gap matrix of service × surrounding city/neighborhood, marking which pages exist vs missing.
12
+ Count the missing pages = ranking opportunities.
13
+
14
+ Phase 2 — Publishing order:
15
+ Recommend which pages to publish first and why (search volume, intent, competition, proximity).
16
+
17
+ Phase 3 — For each priority page, output:
18
+ - full page copy (local angle, not generic)
19
+ - FAQ section + FAQ schema (JSON-LD)
20
+ - internal-linking plan (link to money pages + related city/service pages)
21
+ - image alt text
22
+
23
+ Constraint: every page must have a genuine local angle (real neighborhoods, landmarks,
24
+ local specifics) — no thin doorway pages that only swap the city name.
25
+ ```
26
+
27
+ Then validate schema with `schema-markup-generator` and links with `internal-linking-optimizer`.
@@ -0,0 +1,23 @@
1
+ # GBP category audit
2
+
3
+ Fill `{{business_url_or_gbp}}`.
4
+
5
+ ```
6
+ You are a local SEO expert. Audit the Google Business Profile categories for this business:
7
+ {{business_url_or_gbp}}. First ask clarifying questions until ≥95% confident.
8
+
9
+ Then:
10
+ 1. Identify the current primary + secondary categories (state if unknown / need live check).
11
+ 2. Reverse-engineer every category the top local competitors use for this service + area.
12
+ 3. Recommend categories to ADD, split into:
13
+ - "Add today" — highest correlation, lowest risk (max 3)
14
+ - "Add next week" — secondary, lower correlation
15
+ so Google does NOT flag rapid bulk changes.
16
+ 4. Keep the existing primary category unless there is a strong, stated reason; never swap blindly.
17
+ 5. List "categories I refuse to recommend without you verifying them live."
18
+ 6. Give the strategic reasoning for why this category stack wins for THIS business.
19
+ 7. End with the single next step.
20
+
21
+ Constraints: do not recommend changing all categories at once; do not stuff keywords into
22
+ the business name; primary category stays unless justified.
23
+ ```
@@ -0,0 +1,27 @@
1
+ # GSC page-2 keyword gold mine
2
+
3
+ Prereq: user is logged into Google Search Console in Chrome. Claude reads it via the Claude
4
+ Chrome extension or browser-harness (the user's own session — never enter credentials).
5
+
6
+ ```
7
+ Use my logged-in Google Search Console tab. Pull my query/page performance data.
8
+
9
+ Build a "page-2 gold mine" list with these filters:
10
+ - average position between 8 and 20
11
+ - has impressions
12
+ - query is NOT branded
13
+ - query has commercial or transactional intent
14
+ Sort by impressions, take the top 20.
15
+
16
+ For each of the top 20, open the URL currently ranking and do a forensic audit:
17
+ - keyword in title tag? in H1? in first 100 words?
18
+ - current word count vs the avg of the top-5 ranking pages for that query
19
+ - internal links pointing to this page (count)
20
+ - current meta description
21
+ - schema present on the page?
22
+
23
+ Then for each, REWRITE: new title tag and new meta description.
24
+
25
+ Finally, produce a 30-day sprint: week-by-week, each fix as current state → new state,
26
+ with a short rule set for execution.
27
+ ```
@@ -0,0 +1,26 @@
1
+ # Competitor review sentiment mining
2
+
3
+ Fill `{{business_url}}`.
4
+
5
+ ```
6
+ You are a conversion copywriter + local SEO analyst for: {{business_url}}.
7
+ First ask clarifying questions until ≥95% confident.
8
+
9
+ Phase 1 — Competitor sentiment pool:
10
+ Identify my top 3 competitors. Read ~100 reviews each (200+ total). Extract:
11
+ - 5-star emotional language (the recurring phrases)
12
+ - Top 10 BEFORE-STATE FEARS (what customers feared before booking)
13
+ - Top 15 OUTCOME PHRASES (specific results customers mention)
14
+ - RECOMMENDATION LANGUAGE (exact phrases used when referring others)
15
+ - The 5-star vs 3-star TRUST-TRIGGER GAP (what 5-star reviews praise that 3-star ones complain about)
16
+
17
+ Phase 2 — Gap analysis:
18
+ What do competitors' reviews say that mine don't? Where am I strong / missing?
19
+
20
+ Phase 3 — Rewrites using the customers' EXACT language:
21
+ - GBP description: 3 versions (A/B/C)
22
+ - Homepage headline + subheadline variations
23
+ - FAQ entries that answer the top fears
24
+ - A review-request script
25
+ End with a priority action list.
26
+ ```
@@ -0,0 +1,19 @@
1
+ # MRR Prompt 3 — 30-day money plan
2
+
3
+ ```
4
+ Pretend you ARE that operator. Create a 30-day SEO content plan that needs less than $500
5
+ upfront and gets me to my first ranking article OR first dollar of organic revenue as fast
6
+ as possible. Publishing must start on day one. No research phase longer than 48 hours.
7
+
8
+ Be brutally honest first: state clearly whether a brand-new blog post can realistically rank
9
+ in 30 days, and what actually pays inside 30 days vs the 60–180 day layer.
10
+
11
+ Output:
12
+ - Budget allocation (<$500), itemized — flag what I may NOT need
13
+ - Day-by-day plan with morning/afternoon blocks, grouped:
14
+ Days 1–2 foundation · 3–7 neighborhood pages + first cornerstone · 8–14 reviews + local
15
+ link push · 15–21 first lead + second cornerstone + GBP posting habit · 22–30 outreach #2
16
+ + measurement & triage (GSC)
17
+ - Honest expected 30-day result (reviews, indexation, local 3-pack, leads, closed jobs)
18
+ - A "what I do NOT want to see you doing" list
19
+ ```
@@ -0,0 +1,13 @@
1
+ # MRR Bonus — ruthless cut
2
+
3
+ ```
4
+ Ask me 3 yes/no questions to identify what will actually stop me from publishing this month.
5
+ Then cut the plan in half and keep ONLY the actions that directly lead to rankings and revenue.
6
+
7
+ (Likely questions: can I commit 1 hour/day every day for 30 days? will I publish a page I
8
+ wrote in one sitting, imperfect, without editing for a week? will I text 50 past customers
9
+ for reviews?)
10
+
11
+ Based on my answers, output the streamlined plan and a revised budget — no fluff, no
12
+ rosy "this is easy" framing. Tell me what to drop and why.
13
+ ```
@@ -0,0 +1,17 @@
1
+ # MRR Prompt 1 — Opportunity finder
2
+
3
+ ```
4
+ Find me SEO content angles that could generate my first $1,000 in monthly recurring
5
+ revenue within 90 days. Each angle MUST:
6
+ - target keywords I can realistically rank for WITHOUT high domain authority
7
+ - be tied to a product, service, or affiliate offer I can monetize
8
+ - have proven search intent
9
+ - be publishable within 7 days
10
+
11
+ Ask me clarifying questions ONE AT A TIME until you are ≥95% confident before answering.
12
+ (Expect to ask: existing platform/site? monetization path? specific trade/niche?
13
+ geographic scope? typical client value/month? existing site in this niche?)
14
+
15
+ Output 1–2 angles. For each: target keywords (with intent), a cornerstone-article outline,
16
+ why it converts, and the math to $1k MRR. State your assumptions explicitly.
17
+ ```
@@ -0,0 +1,18 @@
1
+ # MRR Prompt 2 — Role-model study
2
+
3
+ ```
4
+ For my exact situation (use what you learned above: niche, monetization, location, scope),
5
+ who is the SINGLE most successful SEO operator or content-site owner I should study to make
6
+ this happen? Limit it to ONE person or site.
7
+
8
+ Show me exactly what they did in their FIRST 90 DAYS that I should replicate, mapped to my
9
+ niche, broken into:
10
+ - Days 1–14 (foundation)
11
+ - Days 15–45 (money pages)
12
+ - Days 46–90 (compounding)
13
+
14
+ Then list explicitly what they do NOT do that I also shouldn't (e.g. chase national keywords,
15
+ buy backlinks, pump out 50 posts, obsess over keyword tools).
16
+
17
+ End with the single most important lesson from them for my situation, and one honest caveat.
18
+ ```
@@ -0,0 +1,149 @@
1
+ ---
2
+ name: seo-site-builder
3
+ description: End-to-end skill for finding, researching, planning, and building profitable affiliate SEO websites — from niche idea to live Next.js site.
4
+ ---
5
+
6
+ # seo-site-builder
7
+
8
+ **End-to-end skill for finding, researching, planning, and building profitable affiliate SEO websites — from niche idea to live Next.js site.**
9
+
10
+ ## Description
11
+ This skill encodes the complete workflow for building affiliate content sites that rank on Google. It covers niche discovery, deep market research, keyword analysis, competitor intelligence, content planning, financial modeling, and technical site build — using the exact process proven on SaunaRanked.com (Home Infrared Sauna Reviews niche).
12
+
13
+ ## When to Use
14
+ - User says "find me a niche to build an affiliate site"
15
+ - User says "research [niche] for SEO site"
16
+ - User says "build me a niche site for [topic]"
17
+ - User says "run seo-site-builder"
18
+ - User wants to go from zero → live affiliate site
19
+ - User says "yolo" or "do all the work and report after you finish" to trigger full auto mode
20
+
21
+ ## Modes
22
+
23
+ ### 🔵 Interactive Mode (Default)
24
+ Claude presents findings at each stage and waits for user approval before continuing.
25
+ - Shows niche list → user picks → researches → user approves → plans → user confirms → builds
26
+
27
+ ### 🔴 Yolo Mode
28
+ Triggered by: "yolo" OR "do all the work and report after you finish" OR "do everything and report back"
29
+ Claude makes all decisions independently and runs the entire workflow without stopping.
30
+ - Picks best niche automatically based on scoring criteria
31
+ - Runs all research agents in parallel
32
+ - Builds complete plan and site without approval gates
33
+ - Only stops if a critical blocker is found (e.g., niche already saturated)
34
+
35
+ ## Core Principles
36
+
37
+ ### 1. Data Before Decisions
38
+ Never guess. Every niche pick, keyword target, and content decision must be backed by:
39
+ - Real SERP analysis (browser tool)
40
+ - Competitor DA verification
41
+ - Volume + intent confirmation
42
+ - Golden Score / Weakspot data
43
+
44
+ ### 2. No-Backlink First
45
+ Always prioritize keywords a brand new site (DA 0) can rank for WITHOUT backlinks:
46
+ - Target keywords where AVG DA of top 10 results < 50
47
+ - Prefer Weakspot ≥ 2 (2+ beatable pages in top 10)
48
+ - Model-specific reviews always beat generic roundups for new sites
49
+
50
+ ### 3. Parallel Research Always
51
+ Never research serially. Always spawn multiple agents simultaneously:
52
+ - Competitor intel + Keyword research + Monetization run in parallel
53
+ - Financial model + Technical setup + Content strategy run in parallel
54
+ - Synthesis fires only after all agents complete
55
+
56
+ ### 4. Browser-First Verification
57
+ Use Claude browser tools to verify EVERY claim:
58
+ - Open actual SERPs and read who is ranking
59
+ - Check competitor DA signals from their About pages
60
+ - Verify affiliate program existence on brand websites
61
+ - Confirm search volumes via Google autocomplete + PAA boxes
62
+
63
+ ### 5. Maple Light Theme (Product-Demand Niches)
64
+ Target niches where:
65
+ - Products exist and sell ($500+ price point preferred)
66
+ - Amazon has 100+ reviews on top products (proven demand)
67
+ - Biohacking / wellness / home improvement / fitness angle
68
+ - Buyers research extensively before buying (= search traffic)
69
+ - Direct brand affiliate programs exist (higher commissions than Amazon)
70
+
71
+ ## Full Workflow
72
+
73
+ → See `rules/01-niche-discovery.md`
74
+ → See `rules/02-deep-research.md`
75
+ → See `rules/03-keyword-strategy.md`
76
+ → See `rules/04-content-plan.md`
77
+ → See `rules/05-site-build.md`
78
+ → See `rules/06-yolo.md`
79
+
80
+ ## Templates
81
+ → See `templates/niche-scorecard.md`
82
+ → See `templates/article-stub.mdx`
83
+ → See `templates/image-prompt.md`
84
+ → See `templates/keyword-export.md`
85
+
86
+ ## Quick Reference — Workflow at a Glance
87
+
88
+ ```
89
+ PHASE 1: DISCOVERY (10 min)
90
+ → Search/scrape niche ideas from source or Google
91
+ → Score each on: ticket size, competition, affiliate programs, trend
92
+ → Present top 10 list to user
93
+ [INTERACTIVE: User picks | YOLO: Auto-pick top scorer]
94
+
95
+ PHASE 2: DEEP RESEARCH (parallel agents, 30-60 min)
96
+ → Agent 1: Competitor intelligence (browser tool)
97
+ → Agent 2: Keyword research (browser tool + CSV analysis)
98
+ → Agent 3: Monetization & affiliate programs
99
+ → Agent 4: Amazon product & buyer intent research
100
+ → Agent 5: Content strategy & site architecture
101
+ → Agent 6: Domain & branding
102
+ → Agent 7: Link building strategy
103
+ → Agent 8: Financial model
104
+ → Agent 9: Technical setup
105
+ → Agent 10: Traffic growth model
106
+ → Synthesis agent: Master business plan
107
+ [INTERACTIVE: Show plan → user approves | SOLO YOLO: Continue automatically]
108
+
109
+ PHASE 3: KEYWORD STRATEGY (15 min)
110
+ → Export keywords.txt (comma-separated for Ads Planner)
111
+ → Request user to verify in Google Keyword Planner
112
+ → Re-prioritize schedule after volume data returns
113
+ → Build article-schedule.md sorted by: DA asc, Weakspot desc
114
+
115
+ PHASE 4: CONTENT PLAN (30 min)
116
+ → Generate article stubs (MDX frontmatter only)
117
+ → Create image-prompt files per article
118
+ → Build internal linking map
119
+ [INTERACTIVE: Ask to continue to next idea | SOLO YOLO: Continue]
120
+
121
+ PHASE 5: SITE BUILD (2-3 hours)
122
+ → Init Next.js 16.2.1 with pnpm
123
+ → Install Velite + Tailwind + shadcn/ui
124
+ → Build core components
125
+ → Install BMAD in project dir
126
+ → Hand off to BMAD for final build
127
+ ```
128
+
129
+ ## Output Files Per Project
130
+ ```
131
+ /[niche-slug]/
132
+ ├── research/
133
+ │ ├── 01-competitor-analysis.md
134
+ │ ├── 02-keyword-research.md
135
+ │ ├── 03-monetization-analysis.md
136
+ │ ├── 04-amazon-product-research.md
137
+ │ ├── 05-content-strategy.md
138
+ │ ├── 06-domain-branding.md
139
+ │ ├── 07-link-building-strategy.md
140
+ │ ├── 08-financial-model.md
141
+ │ ├── 09-technical-setup.md
142
+ │ ├── 10-traffic-growth-model.md
143
+ │ └── 00-MASTER-BUSINESS-PLAN.md
144
+ ├── docs/
145
+ │ └── article-schedule.md
146
+ ├── keywords.txt ← paste into Google Ads Planner
147
+ ├── bmad/ ← BMAD installed here
148
+ └── CLAUDE.md
149
+ ```
@@ -0,0 +1,64 @@
1
+ # Rule: Niche Discovery
2
+
3
+ ## Trigger
4
+ User provides: a source URL, a broad category, or just says "find me a niche"
5
+
6
+ ## Step 1 — Source Handling
7
+ **If user provides a URL:**
8
+ - Use browser tool to open it
9
+ - Extract all niche/product ideas mentioned
10
+ - Note: price points, buyer intent signals, existing affiliate sites
11
+
12
+ **If user provides a category (e.g., "home wellness", "fitness gear"):**
13
+ - Use browser tool to search: "[category] affiliate niche ideas"
14
+ - Check: Flippa, Empire Flippers, Motion Invest for sold sites in category
15
+ - Search: "[category] site:reddit.com affiliate" for community validation
16
+
17
+ **If user says "find me a niche" (no source):**
18
+ - Use browser tool to search these proven sources:
19
+ 1. `site:empireflippers.com affiliate niche` — recently sold sites
20
+ 2. `site:flippa.com content site sold` — market-validated niches
21
+ 3. `best affiliate niches [current year]` — trend data
22
+ 4. Google Trends for rising product categories
23
+
24
+ ## Step 2 — Niche Scoring Criteria
25
+ Score each idea on these 7 factors (1-5 each, max 35):
26
+
27
+ | Factor | Score 5 | Score 3 | Score 1 |
28
+ |--------|---------|---------|---------|
29
+ | **Ticket Size** | $1,000+ products | $200-$1,000 | Under $200 |
30
+ | **Direct Affiliate Programs** | 3+ brands, 8-15% | 1-2 brands, 5-8% | Amazon only (3%) |
31
+ | **Competition Level** | Small blogs dominate | Mix of small+medium | Forbes/WebMD dominate |
32
+ | **Buyer Research Intent** | Weeks of research | Days of research | Impulse buy |
33
+ | **Trend Direction** | Growing (Google Trends up) | Stable | Declining |
34
+ | **Amazon Demand** | 100+ reviews on top products | 50-100 reviews | Under 50 |
35
+ | **Content Gap** | Major gaps exist | Some gaps | Well-covered |
36
+
37
+ **Minimum threshold to include in list: Score ≥ 18/35**
38
+
39
+ ## Step 3 — Present Top 10 List
40
+ Format exactly as:
41
+ ```
42
+ ┌─────┬───────────────────────────────────┬──────┬──────────────────────────────────────────┐
43
+ │ # │ Niche │Score │ Edge │
44
+ ├─────┼───────────────────────────────────┼──────┼──────────────────────────────────────────┤
45
+ │ 1 │ [Niche Name] │ XX/35│ [One-line why it wins] │
46
+ └─────┴───────────────────────────────────┴──────┴──────────────────────────────────────────┘
47
+ ```
48
+
49
+ ## Step 4 — User Interaction
50
+ **Interactive mode:** "Which niche do you want to deep-dive? (Enter number or 'all')"
51
+ **Solo Yolo mode:** Auto-select #1 (highest score), announce selection, continue immediately
52
+
53
+ ## Maple Light Theme — Preferred Niche Types
54
+ Prioritize niches that have:
55
+ - Physical products with strong online research phase
56
+ - Health / wellness / recovery / biohacking angle
57
+ - Home improvement / comfort upgrade angle
58
+ - Sports performance / fitness recovery angle
59
+ - Gadgets / tech for home use
60
+
61
+ These convert better because buyers:
62
+ 1. Spend weeks researching online
63
+ 2. Trust review sites (not brand sites)
64
+ 3. Have high purchase intent when landing on review content
@@ -0,0 +1,164 @@
1
+ # Rule: Deep Research — 10 Parallel Agents
2
+
3
+ ## When to Run
4
+ After niche is selected (user approved or solo yolo auto-selected)
5
+
6
+ ## Research Directory Structure
7
+ Create immediately:
8
+ ```
9
+ /[project-root]/research/
10
+ ```
11
+
12
+ ## The 10 Research Agents (Launch ALL in Parallel)
13
+
14
+ ### Agent 1 — Competitor Intelligence
15
+ **Goal:** Find top 15 competing domains, their weaknesses, content gaps
16
+ **Browser tool usage:**
17
+ - Search: "best [niche keyword]" → note who ranks top 10
18
+ - Search: "[brand] review" for each major brand → who's reviewing?
19
+ - Check each competitor's About page for domain age, author info
20
+ - Look for: anonymous authors, outdated content, thin reviews, vendor bias
21
+ **Key questions to answer:**
22
+ - Which sites are weakest (anonymous, no testing, thin content)?
23
+ - What content types are MISSING from current top results?
24
+ - Is there a "named expert + independent testing" gap?
25
+ **Output:** `research/01-competitor-analysis.md`
26
+
27
+ ### Agent 2 — Keyword Research
28
+ **Goal:** 100+ keywords scored 🟢🟡🔴, 30-day content roadmap
29
+ **Browser tool usage:**
30
+ - Search each seed keyword → note SERP composition (big brands vs small affiliates)
31
+ - Check Google autocomplete for each seed
32
+ - Read PAA (People Also Ask) boxes for question keywords
33
+ - Search: "[brand name] review" for each brand in niche
34
+ **Scoring:**
35
+ - 🟢 Green: AVG DA < 50, small affiliates ranking, buyer intent
36
+ - 🟡 Yellow: AVG DA 50-65, mix of sites, good intent
37
+ - 🔴 Red: Forbes/Amazon/WebMD dominate, DA 70+
38
+ **Output:** `research/02-keyword-research.md`
39
+
40
+ ### Agent 3 — Monetization & Affiliate Programs
41
+ **Goal:** Every affiliate program, commission rate, cookie duration
42
+ **Browser tool usage:**
43
+ - Search: "[brand name] affiliate program" for each brand
44
+ - Check ShareASale, CJ Affiliate, Impact, Awin for programs
45
+ - Search: "[niche] affiliate program commission"
46
+ - Calculate: commission per sale at each price tier
47
+ **Must answer:**
48
+ - What is Amazon commission % for this product category?
49
+ - Which brands have direct programs paying 5-15%?
50
+ - What is realistic revenue at 1k/5k/10k/50k monthly visitors?
51
+ **Output:** `research/03-monetization-analysis.md`
52
+
53
+ ### Agent 4 — Amazon Product & Buyer Intent
54
+ **Goal:** Top products, buyer pain points, questions buyers ask
55
+ **Browser tool usage:**
56
+ - Search Amazon for main product category
57
+ - Read 1-star and 5-star reviews on top 5 bestsellers
58
+ - Read Q&A sections for buyer questions
59
+ - Check Amazon autocomplete for sub-niches
60
+ **Key findings:**
61
+ - Volume sweet spot (which price range sells most?)
62
+ - Top 3 buyer complaints → become content angles
63
+ - Top questions in Q&A → become FAQ/informational articles
64
+ **Output:** `research/04-amazon-product-research.md`
65
+
66
+ ### Agent 5 — Content Strategy & Site Architecture
67
+ **Goal:** 7 content pillars, site URL structure, first 50 articles
68
+ **Browser tool usage:**
69
+ - Search Reddit for "[niche] buying advice" threads
70
+ - Search: "site:reddit.com [niche keyword]" for buyer questions
71
+ - Check Quora for unanswered niche questions
72
+ **Deliverables:**
73
+ - Full URL structure (/reviews/, /compare/, /guides/, /health/, /best/)
74
+ - First 50 articles in priority order with slugs
75
+ - Article templates for each type
76
+ - 7 differentiators competitors aren't doing
77
+ **Output:** `research/05-content-strategy.md`
78
+
79
+ ### Agent 6 — Domain & Branding
80
+ **Goal:** Best domain name, brand positioning, E-E-A-T strategy
81
+ **Browser tool usage:**
82
+ - Check competitor domain name patterns from SERP
83
+ - Verify top domain candidates pass "radio test"
84
+ **Naming patterns (ranked best to worst):**
85
+ 1. [niche-word] + [authority word]: ranked, advisor, lab, verdict, report
86
+ 2. [adjective] + [niche-word]: the[niche], my[niche]
87
+ 3. Exact match: only if .com available at normal price
88
+ **Avoid:** Non-.com TLDs unless .com is $20k+ premium
89
+ **Output:** `research/06-domain-branding.md`
90
+
91
+ ### Agent 7 — Link Building Strategy
92
+ **Goal:** 12-month link acquisition calendar, 0 PBNs
93
+ **Browser tool usage:**
94
+ - Search: "[competitor domain] mentioned on Reddit"
95
+ - Find relevant subreddits for niche
96
+ - Find Quora questions with weak/no answers
97
+ **Free link sources (always include):**
98
+ - Reddit (r/[niche], r/biohacking, r/homeimprovement)
99
+ - Quora answers
100
+ - Pinterest (start Day 1)
101
+ - YouTube companion channel
102
+ **Digital PR anchor:** Always identify ONE data-driven content piece that earns natural links (EMF test, survey, cost study)
103
+ **Output:** `research/07-link-building-strategy.md`
104
+
105
+ ### Agent 8 — Financial Model
106
+ **Goal:** P&L table (24 months), break-even, IRR, exit valuation
107
+ **Research real prices for:**
108
+ - Namecheap .com domain (~$10/yr)
109
+ - Cloudways DigitalOcean 2GB ($28/mo)
110
+ - Kadence Pro theme ($79/yr)
111
+ - AAWP ($49/yr)
112
+ - Rank Math Pro ($79/yr)
113
+ - Ahrefs Starter ($29/mo)
114
+ **Standard assumptions:**
115
+ - Blended commission: 3.9% (70% Amazon 3% + 30% direct 6%)
116
+ - Conversion rate: 0.75%
117
+ - Break-even: Month 7-9 typically
118
+ - Exit multiple: 32-38x monthly net profit
119
+ **Output:** `research/08-financial-model.md`
120
+
121
+ ### Agent 9 — Technical Setup
122
+ **Goal:** Complete tech stack, plugin list, Day 1 checklist
123
+ **Standard stack (always use):**
124
+ - Hosting: Cloudways DigitalOcean 2GB
125
+ - CMS: Next.js 16.2.1 + Velite + MDX (NOT WordPress unless specifically requested)
126
+ - Theme: Kadence Pro (if WordPress) / Tailwind + shadcn/ui (if Next.js)
127
+ - Affiliate links: AAWP (Amazon) + ThirstyAffiliates (direct brands)
128
+ - SEO: Rank Math Pro
129
+ - Analytics: Google Analytics 4 + Search Console
130
+ **Output:** `research/09-technical-setup.md`
131
+
132
+ ### Agent 10 — Traffic Growth Model
133
+ **Goal:** 24-month traffic projections, 3 scenarios, sandbox timeline
134
+ **Research:**
135
+ - Google sandbox duration for this niche type (YMYL adjacent = 4-6 months)
136
+ - Real case studies from NichePursuits, Income School, Authority Hacker
137
+ - Pinterest sandbox timeline (6-8 months)
138
+ - CTR by position in 2025 (Position 1 = ~19% with AI Overviews)
139
+ **3 scenarios always:**
140
+ - Best: 2x base projections
141
+ - Base: realistic median
142
+ - Worst: sandbox never fully lifts, recovery plan
143
+ **Output:** `research/10-traffic-growth-model.md`
144
+
145
+ ## Synthesis Agent (fires after ALL 10 complete)
146
+ **Input:** All 10 research files
147
+ **Output:** `research/00-MASTER-BUSINESS-PLAN.md`
148
+ **Structure:** 14 sections (Executive Summary → Exit Strategy)
149
+ **Rule:** If synthesis times out, split into PART1 (sections 1-7) and PART2 (sections 8-14) then merge
150
+
151
+ ## Progress Reporting
152
+ After each agent completes, report key finding in this format:
153
+ ```
154
+ ✅ Agent [N] done — [Key insight in one sentence]
155
+ [2-3 bullet points of most important findings]
156
+ ```
157
+
158
+ ## Interactive Gate
159
+ After all 10 + synthesis complete:
160
+ "Research complete for [Niche]. Master plan at research/00-MASTER-BUSINESS-PLAN.md
161
+ Want to:
162
+ 1. Continue to keyword strategy for this niche
163
+ 2. Research the next niche idea first
164
+ 3. Go to site build immediately"