@hanzlaa/rcode 4.3.3 → 4.4.1

package/rcode/commands/lazy.md

@@ -0,0 +1,10 @@
+---
+name: rcode-lazy
+description: "Lazy senior dev lens — force the simplest solution that actually works before any code is written (YAGNI, stdlib first, one line before fifty)"
+argument-hint: "[challenge or code to simplify] [--intensity=lite|full|ultra]"
+allowed-tools:
+  - Read
+  - AskUserQuestion
+---
+
+@rcode/skills/core/rcode-lazy/SKILL.md

package/rcode/data/intent-table.json

@@ -0,0 +1,87 @@
+[
+  {
+    "intent": "new-project",
+    "keywords": ["set up a new project", "initialize a new project", "start a new project", "create a new project"],
+    "command": "/rcode-new-project"
+  },
+  {
+    "intent": "map-codebase",
+    "keywords": ["map the codebase", "map this codebase", "analyze the codebase", "analyse the codebase", "map existing codebase"],
+    "command": "/rcode-map-codebase"
+  },
+  {
+    "intent": "debug",
+    "keywords": ["bug", "getting an error", "throwing an error", "error in the", "fix the error", "debug this", "crash", "failure", "broken", "not working", "fails", "exception", "traceback"],
+    "command": "/rcode-debug"
+  },
+  {
+    "intent": "audit-karpathy",
+    "keywords": ["audit", "review changes", "check my diff", "karpathy", "too complex", "complexity", "code review"],
+    "command": "/rcode-review --karpathy"
+  },
+  {
+    "intent": "lazy",
+    "keywords": ["be lazy", "lazy mode", "simplest solution", "yagni", "over-engineered", "over-engineering", "kam code likho"],
+    "command": "/rcode-lazy"
+  },
+  {
+    "intent": "checkpoint",
+    "keywords": ["checkpoint", "explain this diff", "human review", "walk through the change", "walk through this change"],
+    "command": "/rcode-checkpoint-preview"
+  },
+  {
+    "intent": "brainstorm",
+    "keywords": ["brainstorm", "generate ideas", "explore options", "what could we do", "ideate", "ideas for"],
+    "command": "/rcode-brainstorm"
+  },
+  {
+    "intent": "explore",
+    "keywords": ["explore", "research phase", "do some research", "comparing", "investigate", "look into", "understand how"],
+    "command": "/rcode-research-phase"
+  },
+  {
+    "intent": "discuss",
+    "keywords": ["which one", "better ux", "how should", "still have confusion", "conflicting", "discuss the scope", "design this", "architect this"],
+    "command": "/rcode-discuss-phase"
+  },
+  {
+    "intent": "add-phase",
+    "keywords": ["refactor", "migration", "multi-file", "system redesign", "multi file", "large refactor", "architectural", "integration", "integrate"],
+    "command": "/rcode-add-phase"
+  },
+  {
+    "intent": "sprint-planning",
+    "keywords": ["sprint planning", "plan the sprint", "next sprint", "what's in this sprint"],
+    "command": "/rcode-sprint-planning"
+  },
+  {
+    "intent": "execute-sprint",
+    "keywords": ["run the sprint", "start sprint", "execute sprint", "work on sprint"],
+    "command": "/rcode-execute-sprint"
+  },
+  {
+    "intent": "plan",
+    "keywords": ["let's plan", "plan phase", "plan this", "let me plan", "planning phase", "create a plan", "please plan", "plan and think", "scope this", "scope the feature"],
+    "command": "/rcode-plan"
+  },
+  {
+    "intent": "new-milestone",
+    "keywords": ["create milestones", "plan milestones", "create roadmap", "break project into milestones", "new milestone", "what milestones"],
+    "command": "/rcode-new-milestone"
+  },
+  {
+    "intent": "epics-stories",
+    "keywords": ["create epics", "user stories", "create stories", "epics and stories", "break into epics"],
+    "command": "/rcode-create-epics-and-stories"
+  },
+  {
+    "intent": "feature-drift",
+    "keywords": ["out of date", "out-of-date", "verify docs", "audit feature docs", "fill out existing", "prd drift", "docs vs code"],
+    "command": "/rcode-feature-drift"
+  },
+  {
+    "intent": "audit",
+    "keywords": ["re-audit", "extend the audit", "fill out the", "expand the", "re audit"],
+    "command": "/rcode-audit"
+  }
+]

package/rcode/modules/seo.yaml

@@ -0,0 +1,22 @@
+name: seo
+version: "1.0"
+description: "Full-spectrum SEO skills — content factory, growth orchestrator, audits, writer, site builder, local SEO, on-page and technical auditors"
+requires:
+  - core
+agents: []
+workflows: []
+commands:
+  - seo-content-factory
+  - seo-growth-orchestrator
+  - seo-audit
+  - on-page-seo-auditor
+  - technical-seo-checker
+  - seo-content-writer
+  - seo-site-builder
+  - rank-and-rent-local-seo
+references:
+  # claude-seo plugin agents — NOT bundled. Install separately: npx @hanzlaa/claude-seo install
+  # Routing rules in do.md reference: seo-cluster, seo-programmatic, seo-schema, seo-geo,
+  # seo-local, seo-sxo, seo-technical, seo-content, seo-backlinks, seo-ecommerce,
+  # seo-maps, seo-page, seo-performance, seo-sitemap, seo-drift, seo-dataforseo
+  - claude-seo-plugin-agents.md

package/rcode/references/project-types.yaml

@@ -268,3 +268,78 @@ dev-tool:
     - "What are the minimum dependency versions?"
     - "How will developers discover and install this?"
     - "Do you need a community or plugin ecosystem?"
+
+content-site:
+  display_name: "Content / SEO / Programmatic Site"
+  signals:
+    - rank-and-rent
+    - lead-gen
+    - lead gen
+    - landing pages
+    - programmatic seo
+    - programmatic pages
+    - service pages
+    - location pages
+    - content site
+    - seo site
+    - affiliate site
+    - affiliate
+    - local seo
+    - content farm
+    - niche site
+    - rank and rent
+    - local lead gen
+    - city pages
+    - service area pages
+    - editorial site
+    - blog site
+    - publisher
+    - content marketing
+    - link building
+    - backlink
+    - keyword research
+    - keyword cluster
+    - topic cluster
+    - E-E-A-T
+    - google business profile
+    - gbp
+    - citations
+    - nap audit
+    - schema markup
+    - structured data
+    - rich results
+    - AI overview
+    - AI search
+    - GEO SEO
+    - llms.txt
+    - programmatic seo site
+    - doorway page
+    - thin content
+    - content refresh
+    - crawl budget
+    - indexation
+    - core web vitals
+    - technical seo
+    - on-page seo
+    - digital pr
+    - guest posts
+    - seo content
+    - content strategy
+    - topical authority
+  required_sections:
+    - keyword-strategy
+    - programmatic-page-matrix
+    - internal-link-plan
+    - schema-plan
+    - content-quality-gates
+  skip_sections:
+    - authentication
+    - state-management
+    - authorization
+  discovery_questions:
+    - "What are your 3–5 primary target keywords (and their search intent)?"
+    - "What is the programmatic page matrix? (e.g. 50 services × 20 cities = 1,000 pages, or editorial only)"
+    - "Who are your top 3 organic competitors? (needed for cluster gap analysis)"
+    - "Do you have Google Search Console / analytics access for this domain?"
+    - "What is your content quality gate — minimum word count, E-E-A-T signals, author attribution?"
+    - "What schema types are needed? (LocalBusiness, FAQPage, BreadcrumbList, Product)"

package/rcode/references/verb-dictionary.md

@@ -112,7 +112,7 @@ These are matched alongside §Create / §Add / §Plan verbs to determine the dis
 | epic | `epic`, `epics`, `epics and stories`, **AR:** `ملحمة`, `ملاحم`, `فصل`, `فصول` | `/rcode-create-epics-and-stories` |
 | sprint | `sprint`, `iteration`, **AR:** `سباق`, `جولة`, `دورة عمل`, `سبرنت` | `/rcode-sprint-planning` |
 | PRD | `PRD`, `requirements doc`, `product requirements`, **AR:** `وثيقة المتطلبات`, `متطلبات المنتج`, `وثيقة المنتج` | `/rcode-create-prd` |
-| roadmap | `roadmap`, `plan` (top-level), **AR:** `خارطة طريق`, `خريطة الطريق`, `خطة عامة` | `/rcode-create-milestone` |
+| roadmap | `roadmap`, `plan` (top-level), **AR:** `خارطة طريق`, `خريطة الطريق`, `خطة عامة` | `/rcode-new-milestone` |
 | council | `council`, `majlis`, `panel`, `mashwara`, `salah`, **AR:** `مجلس`, `شورى`, `لجنة`, `استشارة` | `/rcode-council` |
 | plan (verb form — "plan phase N") | `plan`, **AR:** `خطّط`, `خطة` | `/rcode-plan` |
 | story (impl) | `dev story`, `implement story`, `build story`, **AR:** `نفذ القصة`, `طبّق القصة` | `/rcode-dev-story` |

package/rcode/skills/SKILLS_INDEX.md

@@ -56,7 +56,7 @@ Invoked by agents via the capabilities table in their SKILL.md. Organized by SDL
 - `actions/2-plan/rcode-frontend-design` — typography, colours, motion, spatial design
 - `actions/2-plan/rcode-create-epics-and-stories` — break down PRD into epics and stories
 - `actions/2-plan/rcode-create-story` — prepare a dev-ready user story
-- `actions/2-plan/rcode-create-milestone` — create milestone definition
+- `actions/2-plan/rcode-new-milestone` — create milestone definition
 
 ### 3 — Solutioning (3)
 - `actions/3-solutioning/rcode-create-architecture` — architectural decision record (ADR)
@@ -140,6 +140,23 @@ When a user picks capability `DS`, Claude invokes the `rcode-dev-story` skill.
 
 ---
 
+## SEO Module (8)
+
+Full-spectrum SEO skills — content factory, growth orchestrator, audits, writer, site builder, local SEO, on-page and technical auditors.
+
+| Skill | Path | Description |
+|---|---|---|
+| **seo-content-factory** | `rcode/skills/seo/seo-content-factory/` | Continuous organic-traffic growth via produced SEO pages; the production line for content-driven strategies |
+| **seo-growth-orchestrator** | `rcode/skills/seo/seo-growth-orchestrator/` | Strategic SEO orchestrator across five plays: local, affiliate, technical, content-factory, and e-commerce |
+| **seo-audit** | `rcode/skills/seo/seo-audit/` | Full-spectrum SEO audit covering on-page, technical, content, and backlink signals |
+| **on-page-seo-auditor** | `rcode/skills/seo/on-page-seo-auditor/` | On-page analysis covering title tags, meta, headings, keyword integration, and CTR optimization |
+| **technical-seo-checker** | `rcode/skills/seo/technical-seo-checker/` | Technical SEO audit covering crawlability, robots.txt, sitemaps, Core Web Vitals, and indexability |
+| **seo-content-writer** | `rcode/skills/seo/seo-content-writer/` | SEO-optimized content writing with natural keyword integration and E-E-A-T quality signals |
+| **seo-site-builder** | `rcode/skills/seo/seo-site-builder/` | End-to-end affiliate content site builder: niche discovery, keyword analysis, competitor intel, and site build |
+| **rank-and-rent-local-seo** | `rcode/skills/seo/rank-and-rent-local-seo/` | Rank-and-rent local SEO business playbook: niche selection, long-tail targeting, multi-city expansion |
+
+---
+
 ## Licensing
 
 Free to use and adapt.

package/rcode/skills/actions/1-analysis/rcode-prfaq/SKILL.md

@@ -18,7 +18,7 @@ user-invocable: true
 
 - **Refining an existing PRD** — use `rcode-create-prd` or `rcode-edit-prd`.
 - **Brainstorming raw ideas** before there's a concept — use `rcode-brainstorming` first; PRFAQ assumes a candidate concept exists.
-- **Sprint or phase planning** — use `rcode-sprint-planning` / `rcode-create-milestone`.
+- **Sprint or phase planning** — use `rcode-sprint-planning` / `rcode-new-milestone`.
 - **Pure market research with no product hypothesis** — use a research workflow.
 - **Single-question Q&A** — PRFAQ runs a multi-stage gauntlet; for a one-off answer, just answer.
 

package/rcode/skills/actions/4-implementation/rcode-herdr-orchestration/SKILL.md

@@ -2,39 +2,22 @@
 name: rcode-herdr-orchestration
 description: Orchestrate parallel cld agents in herdr — fan-out or autonomous wave campaign.
 triggers:
-  # English — single-shot orchestration
   - "orchestrate agents"
   - "run agents in herdr"
   - "parallel audit"
   - "spin up agents"
-  - "use herdr to do"
-  - "split work across panes"
   - "fan out work in herdr"
   - "multi-agent in herdr"
-  # English — autonomous campaign mode
   - "autonomous fix campaign"
-  - "auto mode"
-  - "auto loop"
   - "run waves of agents"
-  - "dispatch waves"
-  - "100+ commits"
   - "keep working until done"
-  - "complete site audit and fix"
-  # Roman Urdu / Hindi
   - "herdr mein chalao"
-  - "parallel agents lagao"
-  - "panes mein todo"
-  - "ek saath kai agents"
-  - "auto mode chalao"
-  - "waves mein fix karo"
-  - "campaign chalao"
-  # Arabic native
   - "شغّل وكلاء بالتوازي"
-  - "وزّع العمل على عدة وكلاء"
-  - "استخدم herdr"
   - "حملة إصلاح تلقائية"
-  - "موجات من الوكلاء"
-  - "وضع تلقائي"
+not-for:
+  - single-agent or single-file tasks (run directly, no herdr overhead)
+  - interactive step-through work (use /rcode-execute --interactive)
+  - deployment or push operations (herdr only commits locally)
 user-invocable: true
 ---
 

package/rcode/skills/actions/4-implementation/rcode-scaffold-project/SKILL.md

@@ -74,6 +74,53 @@ Then proceed to `./steps/step-01-target.md`.
 | 3b | Brownfield Init | Overlay rcode structure into existing project *(brownfield only)* | `steps/step-03-brownfield.md` |
 | 4 | Post-Setup | Rename, init git, suggest next steps | `steps/step-04-post-setup.md` |
 
+## Post-Clone Checklist (Greenfield)
+
+After cloning the template and before handing off to the user, run these steps in order:
+
+### 1. pnpm-first — Install Dependencies with pnpm
+
+**Never use `npm install`.** Always install with pnpm:
+
+```bash
+corepack enable pnpm   # ensure pnpm is available via corepack
+pnpm install           # install all dependencies
+```
+
+If `package.json` contains a `packageManager` field, verify it is set to a `pnpm@x.y.z` string. If it is missing or set to `npm`, update it to `pnpm` before installing.
+
+### 2. Node.js 20+ Verification
+
+Check `.nvmrc` (if present) and the `engines.node` field in `package.json`. If either targets Node 16 or Node 18, update to `>=20.0.0`:
+
+- `.nvmrc`: change content to `20`
+- `package.json` `engines.node`: change `>=16.0.0` or `>=18.0.0` to `>=20.0.0`
+
+Report the result to the user: "Node target verified: 20+" or "Node target updated from X to 20+".
+
+### 3. Modern Dependency Check
+
+Scan the scaffolded `package.json` for known deprecated packages and flag them to the user:
+
+| Found | Suggestion |
+|-------|-----------|
+| `moment` | Replace with `date-fns` (tree-shakeable, no-timezone footgun) |
+| `axios` | Native `fetch` is available in Node 18+; only keep `axios` if fetch polyfill is needed |
+| `request` | Unmaintained — use native `fetch` or `undici` |
+
+Do **not** auto-remove these; surface the finding and let the user decide.
+
+### 4. rcode Config Scaffold
+
+After cloning, create `.rcode/config.yaml` with starter content if it does not already exist:
+
+```yaml
+project_name: "{PROJECT_NAME}"
+current_phase: 1
+```
+
+Replace `{PROJECT_NAME}` with the actual project name supplied by the user. Do not overwrite an existing `.rcode/config.yaml`.
+
 ## Design Decisions
 
 - **Always clone fresh** — never cache template locally. Template updates are free.
@@ -81,12 +128,24 @@ Then proceed to `./steps/step-01-target.md`.
 - **Safety first** — never touch a non-empty directory without user approval.
 - **Brownfield never overwrites** — in `--here` mode, existing files are never modified.
 - **Minimal assumptions** — ask before acting on any ambiguity.
+- **pnpm always** — never use npm or yarn for installs; always use pnpm via corepack.
+
+### Safety Check: What "non-empty" means
+
+A directory is considered **non-empty** (and therefore protected) if it contains **any files or directories other than**:
+- `.git/` (git metadata only)
+- `README.md` (bare readme with no project code)
+
+Everything else — including `package.json`, `src/`, `.rcode/`, `node_modules/`, dotfiles like `.env` — counts as content. If any such file is present, the safety check triggers and the user must explicitly consent before the skill proceeds.
 
 ## Output Format
 
 - New project directory scaffolded at the specified path
 - Fresh git history (template history stripped, new `git init` applied)
-- `.rcode/config.json` initialized with project name and user preferences
+- `.rcode/config.yaml` initialized with project name and current phase
+- Dependencies installed via `pnpm install`
+- Node.js target verified or updated to 20+
+- Deprecated dependency findings reported (if any)
 - Console summary: path created, files scaffolded, next steps
 
 ## Examples

package/rcode/skills/seo/module.yaml

@@ -0,0 +1,20 @@
+code: seo
+name: "rcode SEO Module"
+
+header: "rcode SEO Module Configuration"
+subheader: "Configure the SEO module for your rcode installation.\nThese settings apply to all SEO skills: content factory, growth orchestrator, audits, and local SEO."
+
+default_seo_vertical:
+  prompt: "What is your primary SEO vertical? (local, affiliate, technical, content-factory, e-commerce, saas, publisher, agency)"
+  default: "general"
+  result: "{value}"
+
+gsc_access:
+  prompt: "Do you have Google Search Console access for the target domain? (yes/no)"
+  default: "no"
+  result: "{value}"
+
+content_quality_gate:
+  prompt: "Minimum word count for SEO content pieces?"
+  default: "1200"
+  result: "{value}"