Commit graph

35 commits

Author SHA1 Message Date
Claude
7405298b4b
fix: resolve the actionable reported issues (#954, #949, #933, #931, #969, #968, #924, #885)
- #954: strip non-spec source/attribution keys from all 39 plugin.json
  manifests so Claude Code's validator accepts them; metadata preserved in
  new .claude-plugin/authoring-notes.json sidecars; check_plugin_json.py now
  hard-fails manifests carrying those keys and sanity-checks the sidecar;
  CLAUDE.md ClawHub schema section updated to the new rule.
- #949: move the c-level-agents plugin out of c-level-advisor/ to a
  top-level directory so the two marketplace sources no longer overlap;
  updated marketplace.json source, homepage, descriptions, all
  cross-references, docs, harness manifest, mirror-tree symlinks/indexes,
  and rebased the moved files' relative links; domain counters trued up
  (18 -> 19 domains).
- #933: replace dead links to the gitignored maintainer-local megaprompts/
  tree with annotated plain-text references (44 files: SKILL.md, READMEs,
  agents, commands).
- #931: DynamoDB on-demand pricing updated to post-Nov-2024 rates
  ($0.625/M writes, $0.125/M strongly consistent reads).
- #969: skill_security_auditor.py and the three dossier scripts reconfigure
  stdout/stderr to UTF-8 (errors=replace) so legacy Windows codepages no
  longer crash at print time; PYTHONUTF8=1 documented.
- #968: Windows Notes section in INSTALLATION.md + README pointer for the
  core.symlinks mirror-tree checkout caveat.
- #924/#885 residuals: hook commands quote "${CLAUDE_PLUGIN_ROOT}" paths in
  all plugin hooks.json/settings.json (space-safe roots); removed the stale
  pre-rename status/review mirror symlinks and index entries left over from
  the memory-status/memory-review rename.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Qgc6RYXWJPr5oW9DHU7zR4
2026-08-21 05:47:37 +00:00
Claude
fcce9592fb
feat(agents): rebuild cs-content-creator + cs-demand-gen-specialist (PR-2)
- cs-content-creator retargeted off the deprecated content-creator stub to
  marketing-skill/skills/content-production; Use-when description; all 4
  script CLIs verified; workflows end at the skill's documented thresholds
  (score >= 70, quality gates as publish blocker)
- cs-demand-gen-specialist now orchestrates all 3 verified targets
  (marketing-demand-acquisition, paid-ads, email-sequence); hard rules
  (margin-adjusted ROAS, no scaling without verified tracking); honest CLI
  for calculate_cac.py (script takes no args — old agent documented a
  phantom invocation)
- marketing-demand-acquisition SKILL.md: same phantom calculate_cac
  invocation corrected (verified no-args run exits 0)
- marketing_skills_roadmap.md deleted: stale planning material, now
  unreferenced after the agent rewrites (was kept in wave-3 only because
  these two agents linked it)

Verified: check_paths 0 findings on both agents; 8 documented CLIs pass
--help; descriptions <= 1024 with Use-when phrasing.

https://claude.ai/code/session_019AJddAL1NADWMXsy1qNPQF
2026-06-11 15:24:57 +00:00
Claude
894fd23334
feat(agents,commands): trigger descriptions + gated workflow upgrades
- 17 root agents gained 'Use when...' trigger descriptions (<=1024 chars);
  cs-product-analyst placeholder body rewritten around real tools
- 21 commands had invalid YAML frontmatter fixed (unquoted inner colons);
  14 commands gained argument-hint; 6 duplicate commands marked with
  canonical-copy sync comments
- /prd: forcing questions + refuse-to-draft gate + required-sections checklist
- /sprint-plan: capacity math + carry-over check + definition-of-ready gate
- /tdd: rebuilt around the real tdd-guide assets with smoke-tested snippets
- cs-senior-engineer repointed from retired release-manager to
  changelog-generator

https://claude.ai/code/session_019AJddAL1NADWMXsy1qNPQF
2026-06-11 03:58:42 +00:00
Claude
c84e322a99
chore(registry,ci): derive counters, register 11 plugins, add CI guards
- marketplace.json: 11 shipped-but-unregistered plugins added (compliance-os,
  snowflake-development, behuman, claude-coach, grill-with-docs,
  llm-cost-optimizer, prompt-governance, business-investment-advisor,
  video-content-strategist, compliance-team-eu-ai-act, compliance-team-iso42001)
  -> 77/77 registered; self-contradicting counts fixed
- counters reconciled to derived ground truth across README.md, CLAUDE.md,
  agents/CLAUDE.md, marketplace.json (346 skills / 17 domains / 584 tools /
  701 references / 93 agents / 99 commands / 77 plugins)
- new guards: scripts/derive_counters.py (--check, gate G3),
  scripts/check_dual_publish.py (11 pairs, gate G4),
  scripts/smoke_scripts.py + smoke_exceptions.txt (gate G8)
- meta-tooling fixes (gate G9): generate-docs.py --help no longer rewrites
  docs/ as a side effect; audit_skills.py --help instant; markdown-html added
  to hermes/vibe/gemini sync scripts and generate-docs domain maps
- ci-quality-gate.yml: compileall completed 9 -> 17 domains; 4 new advisory
  gate steps (continue-on-error pending burn-in)

Verification (all green): check_plugin_json --all 77 OK; check_paths --all 0
findings; check_dual_publish 0 drifted; smoke 586 pass / 0 fail / 11 by-design
exceptions; derive_counters --check pass; compileall 17 domains rc=0.

https://claude.ai/code/session_019AJddAL1NADWMXsy1qNPQF
2026-06-10 14:33:19 +00:00
Claude
a088c8ba77
fix: phantom-path sweep — 888 unresolvable references to zero
A directory reorg added a skills/ path segment; hundreds of references never
followed. This sweep repoints every path-like reference in SKILL.md, agents,
commands, orchestration, and templates to verified on-disk targets:

- 30 root commands + 19 root agents: missing skills/ segment inserted
- 7 c-level persona agents: 17 hallucinated reference filenames substituted
  with the real files (e.g. okr_execution.md -> process_frameworks.md)
- 5 research skills: phantom scripts/office/validate.py step replaced with a
  runnable stdlib zip-integrity check
- email agents: skills frontmatter corrected to productivity/email
- orchestration/ORCHESTRATION.md + templates: stale paths fixed;
  agent-template now requires trigger phrasing in descriptions (root cause)
- 76 more files across engineering, c-level-advisor, compliance-os,
  research-ops, ra-qm, marketing, productivity; dual-publish pairs mirrored
- dead refs dropped/replaced where no target ever existed (REGISTRY.md,
  trend_analyzer.py, cursor-microinteractions.md)

New: scripts/check_paths.py linter (CI gate G1) + narrow allowlist for
teaching examples. Verified: 540 files scanned, 0 unresolvable.

https://claude.ai/code/session_019AJddAL1NADWMXsy1qNPQF
2026-06-10 14:33:00 +00:00
D4R7HV493R
9885d82df0
feat(marketing): add cs-webinar-marketer agent + /cs:webinar command (#789)
Adds cs-webinar-marketer agent + /cs:webinar command wiring the webinar-marketing skill (SKILL.md, stdlib funnel scorer, references, templates, evals) under marketing-skill/skills/. Includes a Windows cross-platform fix to scripts/generate-docs.py (normalizes os.sep to forward slashes — verified no-op on Linux) and regenerated docs. Verified: scorer runs (89/100 sample), frontmatter valid, clean merge into dev with no conflicts.
2026-06-03 16:15:44 +02:00
Claude
5954dfcce1
cleanup(engineering): address remaining 7 polish items from PR #718 bot review
Bundle of low-medium-severity follow-ups that were deferred when PR #720
landed the 3 blocking bugs. None of these silently break correctness —
they're discoverability, consistency, and convention gaps.

Bugs / code-quality:

1. fullstack_decision_engine.py: asymmetric cadence matching
   `inputs.cadence in target or target in inputs.cadence` produced
   asymmetric results — "per-pr" matched "per-pr-with-gates" but not
   vice versa. Profile cadences are intentional alternatives joined
   by "-or-" (e.g. "weekly-or-on-demand" → {weekly, on-demand}); now
   parsed explicitly with "-with-..." modifier suffixes stripped.

   Verified:
     cadence=per-pr → matches per-pr, per-pr-with-gates, daily-or-per-pr
     cadence=daily  → matches daily-or-per-pr (only)
     cadence=on-demand → matches weekly-or-on-demand

2. fullstack_decision_engine.py: rename weight_total/weight_matched
   to w_total/w_matched. Backend and frontend engines already use the
   short form; this aligns the three files as a family.

3. sync-gemini-skills.py: 3-way name collision in dedup logic
   The naive `if name in seen_names: name = parent-name` handled one
   collision but not two. Three "status" skills under "skills" parent
   dirs produced two entries both named "skills-status". Now suffixes
   with -2, -3, ... so each entry has a unique index name. Eliminates
   the duplicate-name ambiguity surfaced when checking PR #713.

Discoverability:

4. senior-fullstack/SKILL.md: surface fullstack_decision_engine.py in
   the labeled "Tools" section at the top. Previously only mentioned
   inline in the body (5 references buried in the Stack Decision Matrix
   section); not findable when scanning the SKILL.md.

Conventions / v2.8.0 compliance:

5. commands/cs-{fullstack,backend,frontend}-review.md: add explicit
   "## Forcing-question library" section header per the v2.8.0
   convention. Each lists the 7 questions inline with a pointer to
   the canonical reference file.

6. agents/engineering/cs-{fullstack,backend,frontend}-engineer.md:
   alphabetize the specialist list in the description field (annotated
   that workflow body order remains dependency-driven). Makes the
   three agent descriptions consistent as a family.

7. agents/engineering/cs-{backend,frontend}-engineer.md: promote the
   "Cross-agent invocation" content out of Workflow 3 into a dedicated
   "## When invoked as fork target" section with an explicit question-
   skip table per parent agent (cs-fullstack-engineer, cs-cto-advisor,
   cs-vpe-advisor, cs-ciso-advisor for backend; cs-fullstack-engineer,
   cs-content-creator, cs-product-manager for frontend). Closes the
   cross-agent contract gap the bot flagged.

Not changed:

- CLAUDE.md plugin-schema section (already corrected in #715; bot's
  "stale text" claim was incorrect — it was reading the cumulative diff)
- Workflow body specialist order (intentional dependency order; would
  break the SLO-first → API → DB → migration → observability sequence)

Verification:
- All 3 decision engines: --sample → exit 0
- Cadence matching: 3 test cases pass cleanly
- check_plugin_json.py --all → 0 FAIL, 0 WARN, 69 OK
- sync-gemini-skills.py → 392 unique names (was 391 unique / 1 dupe)
2026-05-21 13:47:08 +00:00
claude[bot]
59e5e48cc9 fix(agents): remove hardcoded model from engineering agents to inherit user settings
Remove 'model: sonnet' from cs-fullstack-engineer, cs-frontend-engineer,
and cs-backend-engineer YAML frontmatter so each agent inherits the model
configured in the user's Claude Code settings instead of being locked to sonnet.

Co-authored-by: Alireza Rezvani <alirezarezvani@users.noreply.github.com>
2026-05-21 04:59:09 +00:00
Claude
2c5a793128
feat(engineering): apply karpathy-coder + Matt Pocock to fullstack/frontend/backend
Audit findings:
- senior-fullstack / senior-frontend / senior-backend SKILL.md files were
  generic role catalogs with no opinionated workflow, no customization
  surface, and no cross-agent invocation contract.
- A 4-person SaaS startup and a 200-engineer enterprise read identical
  recommendations.
- Other agents/skills had no typed surface to orchestrate fullstack /
  frontend / backend lenses.

Per-skill additions (21 new files: 7 x 3 skills):
- scripts/<role>_decision_engine.py - stdlib-only deterministic profile
  picker. Refuses to recommend without Karpathy-#1 core assumptions.
  Surfaces kill criteria. Names human approver chain (never auto-approves).
- profiles/*.json x 4 per skill (12 total) - JSON customization surface.
  Users copy one to <your-org>.json to override defaults.
- references/forcing_questions.md - 7 Matt Pocock forcing questions per
  skill (21 total) with recommended answer + canon citation + kill criterion.
- references/composition_map.md - explicit routing into POWERFUL-tier
  specialists (api-design-reviewer, database-designer, slo-architect,
  performance-profiler, a11y-audit, epic-design, apple-hig-expert, etc.).

Three orchestrator agents (context: fork):
- agents/engineering/cs-fullstack-engineer.md
- agents/engineering/cs-frontend-engineer.md
- agents/engineering/cs-backend-engineer.md
Invokable by other agents via Agent(subagent_type="cs-<role>-engineer", ...).

Four slash commands:
- /cs:fullstack-review, /cs:frontend-review, /cs:backend-review
- /cs:engineer-grill - cross-role 21-question forcing-question runner

Augmented SKILL.md files (additive only - Karpathy #3 surgical):
Each gained 5 new sections: Assumptions & Verifiable Success Criteria
(Karpathy #1+#4), Customization profiles, Composition map, Forcing-question
library, Invocation from other agents and skills.

Verification:
- 12/12 profile JSON files parse cleanly
- 3/3 decision engines pass --help and --sample, exit 0
- 3/3 cs-* agents have valid YAML + context: fork
- 3/3 agent paths resolve from agents/engineering/
- 3/3 commands reference the correct cs-* agent
- 69/69 plugin.json files pass check_plugin_json.py
- Existing SKILL.md content unchanged (additive edits only)

Versions: engineering-team plugin 2.2.3 -> 2.8.1; marketplace entry 2.8.1.

https://claude.ai/code/session_01UyWs4rKccdxUWFcWi6Y8Ly
2026-05-20 07:24:21 +00:00
Claude
7c54a72d94
chore(v2.7.3): release prep — docs sync + audit fixes + CHANGELOG
Post-merge sync of v2.7.3 (#679 already in dev). Three things in one
commit:

## 1. /update-docs pipeline (Steps 1-7)

Cross-platform sync verified clean across 3 platforms (.codex 305 /
.gemini 355 / .hermes 305 — aeo + security-guidance present in all
three indexes). 401 → 403 MkDocs pages generated.

**Files refreshed to v2.7.3 / 313 / 46+ / 60+ counts:**

- `.claude-plugin/marketplace.json` — top-level description + metadata
  description + metadata.version (was 2.7.0).
- `CLAUDE.md` — Current Scope line, new v2.7.3 Highlights section,
  footer (Last Updated + Version + Status).
- `README.md` — tagline, badges, Skills Overview row counts (Engineering
  POWERFUL 44 → 45, Marketing 44 → 45 w/ 8 pods), Python Tools count,
  FAQ counts. Hermes footnote ticked v2.7.2 → v2.7.3.
- `docs/index.md` — title, meta description, hero subtitle, grid card.
- `docs/getting-started.md` — meta description, FAQ count.
- `mkdocs.yml` — site_description + 3 nav entries (skill + agent + cmd).
- `marketing-skill/.claude-plugin/plugin.json` — 44 → 45 skills, 7 → 8
  pods, v2.2.3 → v2.7.3.
- `marketing-skill/CLAUDE.md` — 43 → 45 skill count, 32 → 58 Python
  tools, 7 → 8 pods. Added AEO skill to skill map.

## 2. /plugin-audit on both new skills (full 8-phase pipeline)

**aeo (marketing-skill/skills/aeo/)** — PASS WITH WARNINGS:
- Phase 2 Structure: 86.4/GOOD (after auto-fix of YAML frontmatter
  parse error — colon in description value needed quote-wrapping)
- Phase 3 Quality: 52.4/D (validator expects legacy fields v2.7 skills
  don't use — repo-wide pattern, not a defect)
- Phase 4 Scripts: 3/3 PASS
- Phase 5 Security: 2 HIGH NET-EXFIL findings on urllib.request — same
  known false-positive as sister seo-audit skill (URL fetch is core
  functionality for content-audit-by-URL tools, not exfiltration)
- Phase 6 Marketplace: plugin.json valid (v2.7.3, all required fields)
- Phase 7 Ecosystem: indexed in all 3 platforms
- Phase 8 Code Review: 22 workflow sections, refs cite 8/17/37 sources
  (≥7 floor met), 0 broken links, attribution present

**security-guidance (engineering/security-guidance/)** — PASS WITH
WARNINGS:
- Phase 2/3/4: low scores due to hook-plugin layout mismatch with
  script-plugin validators (hook plugins use `hooks/` not `scripts/`
  per Claude Code spec — fundamental structural mismatch, not a defect)
- Phase 5: 6 CRITICAL + 4 HIGH findings are all recursive false-
  positives — auditor detects the hook's OWN pattern-detection strings
  (`"exec("`, `"eval("`, `"yaml.load("` are substring literals used as
  detection rules, NOT actual calls). Verified zero real exec/eval
  calls in the file.
- Phase 6/7: clean (plugin.json valid, hooks.json valid, indexed in
  all 3 platforms, mkdocs nav entry added)
- Phase 8: 291 LOC, syntax valid, clear exit-code contract (0=clean,
  2=block per Claude Code hook spec), session-state caching @ lines
  158-191, 30-day cleanup @ line 163, attribution full, live smoke
  test (`eval(input())` in Write → exit 2 + warning) PASS
- **Real defects: 0.**

## 3. Layout fix (Phase 7 audit catch)

The /plugin-audit Phase 7 caught a real layout bug: cs-aeo.md placed
at `marketing-skill/agents/cs-aeo.md` and `marketing-skill/commands/
cs-aeo.md` was unreachable by `scripts/generate-docs.py` (which only
walks root `agents/<domain>/` and root `commands/`). Result: docs/
pages for cs-aeo agent + /cs:aeo command were never generated.

**Moved to repo-canonical locations:**
- `marketing-skill/agents/cs-aeo.md` → `agents/marketing/cs-aeo.md`
- `marketing-skill/commands/cs-aeo.md` → `commands/cs-aeo.md`

Cleaned empty `marketing-skill/agents/` + `marketing-skill/commands/`
directories. Re-ran `scripts/generate-docs.py`: 401 → 403 pages
(73 agents + 34 commands — both new entries present).

## CHANGELOG.md

Added [2.7.3] - 2026-05-17 entry with full Added / Changed / Layout
fix / Cross-platform sync / Honest audit results / PRs / Verification
sections. Audit results documented verbatim including the known
false-positives — no claims of clean security where the auditor flagged
patterns it can't disambiguate.

https://claude.ai/code/session_01FEUmeuYhmnxVFq7EZM8ZSw
2026-05-17 07:44:02 +00:00
Claude
58905866c5
fix(c-level): add 3 missing voice specs + fix broken paths in cs-ceo/cs-cto agents
Pure-cleanup PR addressing carry-over items deferred across PRs #618-#626 per
karpathy principle #3 (surgical scope — no unrelated cleanups inside scoped
feature PRs).

Voice specs added to persona-voices.md (3 missing entries):

- cs-ceo-advisor — The Strategic Translator (tree-of-thought reasoning;
  refuses to debate tactics until the strategic question is named)
- cs-cto-advisor — The Architecture-First Pragmatist (ReAct reasoning;
  treats every architecture decision as a 3-year commitment)
- cs-general-counsel-advisor — The Risk-Paranoid Lawyer (Not Your Lawyer);
  carry-over from v2.5.1

All three agents existed but were never added to the persona reference. The
voice catalog now matches the cs-* agent set 1:1.

Broken paths fixed in 2 pre-existing agent files:

- agents/c-level/cs-ceo-advisor.md: 32 path corrections from
  '../../c-level-advisor/ceo-advisor/' to '../../c-level-advisor/skills/ceo-advisor/'
  (correct path; the bundled skill lives under skills/)
- agents/c-level/cs-cto-advisor.md: 25 path corrections from
  '../../c-level-advisor/cto-advisor/' to '../../c-level-advisor/skills/cto-advisor/'
- YAML 'skills:' frontmatter field also corrected in both

Validation:
- karpathy-coder/diff_surgeon: 0 findings
- Verified target folders exist (c-level-advisor/skills/ceo-advisor/SKILL.md +
  c-level-advisor/skills/cto-advisor/SKILL.md)

No skill/agent/command count changes; no manifest version bumps. This is a
pure-fix PR. CHANGELOG entry as v2.5.6.

https://claude.ai/code/session_012WtZMm5NJHqkYoRqA9fHMN
2026-05-13 07:17:31 +00:00
Reza Rezvani
9c2facebf4 fix(karpathy-coder): pass 8-phase plugin audit + wire repo integration
Auto-fixes from plugin-audit pipeline:

Phase 2 (70.4 → 75.0 GOOD):
- Added README.md with quick start, tool descriptions, enforcement levels

Phase 3 (51.7 → 63.5, above 60):
- Added expected_outputs/ with 4 JSON fixtures (one per tool)
- Completeness 66.7 → 85.0

Phase 6 (marketplace + agent + command):
- Added karpathy-coder to .claude-plugin/marketplace.json (category: development)
- Mirrored cs-karpathy-reviewer to agents/engineering/
- Mirrored /karpathy-check to commands/
- mkdocs.yml: added skill + command nav entries

Phase 7 (ecosystem sync):
- Ran sync-codex-skills.py + sync-gemini-skills.py
- karpathy-coder now in both indexes

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-04-12 13:34:55 +02:00
Reza Rezvani
b6ca45ddec feat(engineering): add llm-wiki plugin — second brain for Claude Code + Obsidian
Implements Karpathy's LLM Wiki pattern as a production-grade plugin. The LLM
incrementally ingests sources into a persistent, interlinked Obsidian vault —
updating entity/concept/source pages, flagging contradictions, maintaining an
index and append-only log. Knowledge compounds instead of being re-derived by
RAG on every query.

Plugin contents (engineering/llm-wiki/):
- SKILL.md with `context: fork` frontmatter for skill chaining
- 3 sub-agents: wiki-ingestor, wiki-librarian, wiki-linter
- 5 slash commands: /wiki-init, /wiki-ingest, /wiki-query, /wiki-lint, /wiki-log
- 8 Python tools (stdlib only): init_vault, ingest_source, update_index,
  append_log, wiki_search (BM25), lint_wiki, graph_analyzer, export_marp
- 8 reference docs: schema, page-formats, ingest/query/lint workflows,
  obsidian-setup, cross-tool-setup, memex-principles
- Vault templates: CLAUDE.md, AGENTS.md, .cursorrules, index.md, log.md,
  5 page templates (entity, concept, source, comparison, synthesis)
- Worked example vault on "LLM interpretability"
- .claude-plugin/plugin.json manifest

Cross-tool compatibility: the scripts are pure Python stdlib. Only the schema
loader changes per tool (CLAUDE.md for Claude Code, AGENTS.md for Codex CLI /
Cursor / Antigravity / OpenCode / Gemini CLI, .cursorrules for legacy Cursor).
init_vault.py --tool all installs all three.

Repo-level registration:
- Commands mirrored to top-level commands/ for repo-wide discovery
- Agents mirrored to agents/engineering/ as cs-wiki-{ingestor,librarian,linter}
- .claude-plugin/marketplace.json: new llm-wiki entry + version bump to v2.3.0
- CLAUDE.md updated: 234 skills, 313 Python tools, 432 refs, 28 agents, 27 commands

Also saved (deferred): craighewitt-mattpocock reimplementation plan at
documentation/implementation/ — 4-pod proposal for building better versions
of selected skills from thecraighewitt-skills and mattpocock-skills
collections. Not executed; awaiting user confirmation on scope.

End-to-end smoke test passed: init_vault → ingest → update_index → append_log
→ wiki_search → lint → graph_analyzer → export_marp all run against a fresh
vault with real pages, wikilinks, and frontmatter.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-04-11 01:14:11 +02:00
Reza Rezvani
ce1d7925cc feat(engineering): integrate focused-fix skill — docs, command, agent, marketplace
- Normalize SKILL.md frontmatter to repo standard (remove non-standard
  license, metadata.* fields; inline description)
- Generate docs page (docs/skills/engineering/focused-fix.md)
- Add to mkdocs.yml nav (skills + commands)
- Create /focused-fix slash command (commands/ + .claude/commands/)
- Add to cs-senior-engineer agent (skill integration + new workflow #4)
- Update marketplace.json and plugin.json descriptions (30 → 31 skills)

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-23 13:59:30 +01:00
Reza Rezvani
2f57ef8948 feat(agenthub): add AgentHub plugin with cross-domain examples, SEO optimization, and docs site fixes
- AgentHub: 13 files updated with non-engineering examples (content drafts,
  research, strategy) — engineering stays primary, cross-domain secondary
- AgentHub: 7 slash commands, 5 Python scripts, 3 references, 1 agent,
  dry_run.py validation (57 checks)
- Marketplace: agenthub entry added with cross-domain keywords, engineering
  POWERFUL updated (25→30), product (12→13), counts synced across all configs
- SEO: generate-docs.py now produces keyword-rich <title> tags and meta
  descriptions using SKILL.md frontmatter — "Claude Code Skills" in site_name
  propagates to all 276 HTML pages
- SEO: per-domain title suffixes (Agent Skill for Codex & OpenClaw, etc.),
  slug-as-title cleanup, domain label stripping from titles
- Broken links: 141→0 warnings — new rewrite_skill_internal_links() converts
  references/, scripts/, assets/ links to GitHub source URLs; skills/index.md
  phantom slugs fixed (6 marketing, 7 RA/QM)
- Counts synced: 204 skills, 266 tools, 382 refs, 16 agents, 17 commands,
  21 plugins — consistent across CLAUDE.md, README.md, docs/index.md,
  marketplace.json, getting-started.md, mkdocs.yml
- Platform sync: Codex 163 skills, Gemini 246 items, OpenClaw compatible

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-17 12:10:46 +01:00
Leo
a6f428cb0d refine(personas): rewrite with original voice — opinionated colleagues, not job descriptions
- Cut 70% bloat (750 lines removed, 220 added)
- Dropped corporate sections (Core Capabilities, Decision Framework → merged naturally)
- Commands as the centerpiece — what you DO, not what you ARE
- 'How You Think' + 'What You Never Do' = personality, not résumé
- 'When to Use Me' with / = clear routing
- 'What Good Looks Like' = success without corporate metric tables

Our format: opinionated colleague with tools
Agency-agents format: job description with capabilities
Different on purpose.
2026-03-14 00:49:21 +01:00
Leo
da734fe9dd refine(personas): add Core Capabilities, Decision Framework, Success Metrics
Aligns new personas with agency-agents structure:
- Core Capabilities: scannable bullet-list summary
- Decision Framework: when to use (and when NOT to)
- Success Metrics: quantified outcomes

All 4 Tier 1 personas now match full agency-agents spec.
2026-03-14 00:42:47 +01:00
Leo
8a14a069d0 feat(personas): add 4 Tier 1 personas with bundled skills and direct commands
- Content Strategist: 6 commands (/content:audit, cluster, brief, calendar, repurpose, seo), 8 bundled skills
- Product Manager: 7 commands (/pm:story, prd, prioritize, experiment, sprint, retro, metrics), 6 bundled skills
- DevOps Engineer: 7 commands (/devops:deploy, infra, docker, monitor, incident, security, cost), 4 bundled skills
- Finance Lead: 6 commands (/finance:model, fundraise, pricing, burn, unit-economics, board), 2 bundled skills

Total personas: 3 → 7
2026-03-14 00:38:52 +01:00
Leo
da3e34e046 refine: align persona format with agency-agents structure (99% match)
Restructured all 3 personas + template + README to match the
agency-agents agent format:

Frontmatter alignment:
- name, description, color, emoji, vibe, tools (same fields)
- Removed non-standard fields: type, domain, skills, commands, model

Body structure alignment:
- Second-person voice: 'You are **AgentName**...'
- Emoji section headers throughout (🧠 🎯 🚨 📋 🔄 💭 🚀)
- Identity & Memory → Core Mission → Critical Rules → Capabilities
  → Workflows → Communication Style → Success Metrics → Advanced
  → Learning & Memory
- Rich personality backstory (not just skill lists)
- Concrete code/workflow examples in each section
- Pattern recognition subsection in Learning & Memory

Content deepening:
- startup-cto: 112 → 196 lines, added due diligence prep, incident response
- growth-marketer: 111 → 204 lines, added viral growth, international expansion
- solo-founder: 125 → 213 lines, added quit-your-job framework, pivot decisions
- Template rewritten to match exact section structure
- README updated with correct field documentation
2026-03-12 06:00:32 +01:00
Leo
d8bf96569c feat: add persona-based agents with curated skill loadouts
Add agents/personas/ directory with:
- README.md — what personas are, how to use them, comparison with agents
- TEMPLATE.md — format specification for creating new personas
- startup-cto.md — technical co-founder persona (engineering + strategy)
- growth-marketer.md — bootstrapped growth persona (marketing + analytics)
- solo-founder.md — all-in-one indie hacker persona (cross-domain)

Each persona includes:
- Identity & mindset (personality-driven, not just skill list)
- Curated skill loadouts (primary + secondary)
- Multi-step workflows for common tasks
- Handoff rules for cross-persona collaboration
- Anti-patterns to avoid

Complements existing agents/ structure — personas for role embodiment,
agents for focused task execution.
2026-03-12 05:48:02 +01:00
Reza Rezvani
e2fff2f8f2 docs: sync counts and regenerate pages for product team expansion
Update all documentation to reflect 177 skills, 254 tools, 357 references,
16 agents, and 17 commands. Add 4 new skill pages, 1 agent page, and
2 command pages to MkDocs site. Sync Codex (156) and Gemini (218) indexes.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-11 15:15:39 +01:00
Leo
d740f77ef7 feat: add product specialist agent definitions 2026-03-11 14:58:45 +01:00
Reza Rezvani
2d5f846c58 docs: sync counts across CLAUDE.md, README, and agents guide
- CLAUDE.md: Marketing 42→43, pages 206→210+, date updated
- README.md: Python tools 245→250
- agents/CLAUDE.md: agent count 6→15, skill count 42→173, full agent table

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-11 12:54:54 +01:00
Reza Rezvani
4e9f1d934d feat(engineering): add google-workspace-cli skill with 5 Python tools
New skill for Google Workspace administration via the gws CLI:
- SKILL.md with 4 workflows (Gmail, Drive/Sheets, Calendar, Security Audit)
- 5 stdlib-only Python scripts (doctor, auth setup, recipe runner, audit, analyzer)
- 3 reference docs, 2 asset files, 43 built-in recipes, 10 persona bundles
- cs-workspace-admin agent, /google-workspace slash command
- Standalone marketplace plugin entry with .claude-plugin/plugin.json
- Cross-platform sync (Codex CLI, Gemini CLI), MkDocs docs pages
- All documentation updated (173 skills, 250 tools, 15 agents, 15 commands)

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-11 09:59:40 +01:00
Leo
418de87449 docs: add ClawHub publishing constraints to CLAUDE.md, agents/CLAUDE.md, GEMINI.md
- cs- prefix for slug conflicts only (ClawHub registry, not repo)
- No paid/commercial service dependencies
- Rate limit: 5 new skills/hour
- plugin.json schema enforcement
- Version must match repo release
2026-03-10 19:27:16 +01:00
Reza Rezvani
cb3fa6b7ea feat: integrate saas-metrics-coach, add finance commands, remove seek-and-analyze-video
- Integrate saas-metrics-coach into cs-financial-analyst agent with SaaS health
  and unit economics workflows
- Add /financial-health and /saas-health slash commands
- Add /update-docs repo command for post-creation sync pipeline
- Remove seek-and-analyze-video skill (requires paid external API)
- Update all documentation (CLAUDE.md, README.md, docs site, marketplace)
- Sync Codex CLI (150 skills), Gemini CLI (207 items), fix count consistency
- Regenerate 206 MkDocs pages, fix docs/index.md meta 170→171,
  getting-started.md finance bundle 1→2

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-10 14:29:41 +01:00
Reza Rezvani
670a1a61f3 fix: audit and repair all plugins, agents, and commands
- Fix 12 command files: correct CLI arg syntax, script paths, and usage docs
- Fix 3 agents with broken script/reference paths (cs-content-creator,
  cs-demand-gen-specialist, cs-financial-analyst)
- Add complete YAML frontmatter to 5 agents (cs-growth-strategist,
  cs-engineering-lead, cs-senior-engineer, cs-financial-analyst,
  cs-quality-regulatory)
- Fix cs-ceo-advisor related agent path
- Update marketplace.json metadata counts (224 tools, 341 refs, 14 agents,
  12 commands)

Verified: all 19 scripts pass --help, all 14 agent paths resolve, mkdocs
builds clean.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-10 01:17:31 +01:00
Reza Rezvani
67f3922e4f feat(product,pm): world-class product & PM skills audit — 6 scripts, 5 agents, 7 commands, 23 references/assets
Phase 1 — Agent & Command Foundation:
- Rewrite cs-project-manager agent (55→515 lines, 4 workflows, 6 skill integrations)
- Expand cs-product-manager agent (408→684 lines, orchestrates all 8 product skills)
- Add 7 slash commands: /rice, /okr, /persona, /user-story, /sprint-health, /project-health, /retro

Phase 2 — Script Gap Closure (2,779 lines):
- jira-expert: jql_query_builder.py (22 patterns), workflow_validator.py
- confluence-expert: space_structure_generator.py, content_audit_analyzer.py
- atlassian-admin: permission_audit_tool.py
- atlassian-templates: template_scaffolder.py (Confluence XHTML generation)

Phase 3 — Reference & Asset Enrichment:
- 9 product references (competitive-teardown, landing-page-generator, saas-scaffolder)
- 6 PM references (confluence-expert, atlassian-admin, atlassian-templates)
- 7 product assets (templates for PRD, RICE, sprint, stories, OKR, research, design system)
- 1 PM asset (permission_scheme_template.json)

Phase 4 — New Agents:
- cs-agile-product-owner, cs-product-strategist, cs-ux-researcher

Phase 5 — Integration & Polish:
- Related Skills cross-references in 8 SKILL.md files
- Updated product-team/CLAUDE.md (5→8 skills, 6→9 tools, 4 agents, 5 commands)
- Updated project-management/CLAUDE.md (0→12 scripts, 3 commands)
- Regenerated docs site (177 pages), updated homepage and getting-started

Quality audit: 31 files reviewed, 29 PASS, 2 fixed (copy-frameworks.md, governance-framework.md)

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-10 01:08:45 +01:00
Alireza Rezvani
fa07912835
feat: add 6 agents + 5 slash commands for full coverage (v2.7.0) (#293)
Phase 3: 6 new agents (all 9 categories covered) + 5 slash commands.
2026-03-07 12:36:03 +01:00
Reza Rezvani
fc565cac54 docs(agents): add production agents table to CLAUDE.md
Day 5: Documentation Updates - Added catalog of 5 completed agents

## Agents Cataloged
- cs-content-creator (327 lines) - Marketing domain
- cs-demand-gen-specialist (289 lines) - Marketing domain
- cs-ceo-advisor (360 lines) - C-Level domain
- cs-cto-advisor (412 lines) - C-Level domain
- cs-product-manager (407 lines) - Product domain

Total: 1,795 lines of agent documentation
Template: agent-template.md (318 lines)

Sprint: sprint-11-05-2025 (Day 5)
Issue: #15
2025-11-05 14:47:38 +01:00
Reza Rezvani
005e64caf8 feat(agents): implement cs-product-manager agent and agent template
Day 4: Product Agent + Template - Complete implementation of product
management agent and comprehensive template for future agent development.

## cs-product-manager
- Product management agent for feature prioritization and customer discovery
- RICE framework implementation, customer interview analysis, PRD development
- 4 complete workflows: feature prioritization & roadmap, customer discovery,
  PRD development, quarterly planning & OKRs
- Integration with rice_prioritizer.py and customer_interview_analyzer.py tools
- Success metrics: <2 days decision speed, 10-15 interviews per sprint,
  >90% engineering clarity, >60% feature adoption

## agent-template.md
- Comprehensive template for creating new cs-* agents
- 318 lines with detailed instructions and examples
- All required sections documented with explanatory comments
- References 5 completed agents as examples
- Includes YAML frontmatter structure, workflow patterns, integration examples

## Quality Validation
 YAML frontmatter with all required fields
 cs-* prefix naming convention
 4 workflows (exceeds minimum 3)
 Relative paths tested and validated
 Integration examples with bash scripts
 Success metrics defined with targets
 Template includes comprehensive instructions

Sprint: sprint-11-05-2025 (Day 4)
Issues: #13, #14
Files: 2 files, 725 total lines
2025-11-05 14:12:32 +01:00
Reza Rezvani
810a082471 feat(agents): implement cs-ceo-advisor and cs-cto-advisor agents
Day 3: C-Level Agents - Complete implementation of two production-ready
C-level advisory agents with comprehensive workflows and skill integration.

## cs-ceo-advisor
- Strategic leadership advisor for CEOs
- Vision, strategy, board management, investor relations, organizational culture
- 4 complete workflows: annual strategic planning, board meeting preparation,
  fundraising campaign execution, organizational culture transformation
- Integration with financial_scenario_analyzer.py and strategy_analyzer.py tools
- Success metrics: 90%+ vision clarity, 80%+ strategy execution, 18+ months runway

## cs-cto-advisor
- Technical leadership advisor for CTOs
- Technology strategy, team scaling, architecture decisions, engineering excellence
- 4 complete workflows: technical debt assessment, team scaling & hiring,
  technology evaluation & decision, engineering metrics dashboard
- Integration with tech_debt_analyzer.py and team_scaling_calculator.py tools
- Success metrics: 99.9%+ uptime, >1 deployment/day (DORA elite), <10% attrition

## Quality Validation
 YAML frontmatter with all required fields
 cs-* prefix naming convention
 Relative paths (../../) tested and validated
 4 workflows per agent (exceeds minimum 3)
 Integration examples with bash scripts
 Success metrics defined (DORA benchmarks for CTO)
 Related agents cross-referenced
 CEO: 360 lines, CTO: 412 lines (772 total)

Sprint: sprint-11-05-2025 (Day 3)
Issue: #12
Files: 2 agent files, 772 total lines
2025-11-05 13:53:40 +01:00
Reza Rezvani
a26baa8088 feat(agents): implement cs-content-creator and cs-demand-gen-specialist agents
Day 2: Marketing Agents - Complete implementation of two production-ready
marketing agents with comprehensive workflows and skill integration.

## cs-content-creator
- AI-powered content creation specialist
- Brand voice analysis and SEO optimization
- 4 complete workflows: blog post creation, multi-platform adaptation,
  content audit, campaign planning
- Integration with brand_voice_analyzer.py and seo_optimizer.py tools
- Success metrics: 80%+ brand consistency, 75+ SEO score average

## cs-demand-gen-specialist
- Demand generation and customer acquisition specialist
- CAC calculation and conversion funnel optimization
- 4 complete workflows: multi-channel campaign launch, funnel analysis,
  channel benchmarking, lead magnet development
- Integration with calculate_cac.py tool
- Success metrics: 20-30% MOM growth, 15-20% CAC reduction

## Quality Validation
 YAML frontmatter with all required fields
 cs-* prefix naming convention
 Relative paths (../../) tested and validated
 4 workflows per agent (exceeds minimum 3)
 Integration examples with real bash scripts
 Success metrics defined
 Related agents cross-referenced

Sprint: sprint-11-05-2025 (Day 2)
Issue: #11
Files: 2 agent files, 1,089 total lines
2025-11-05 13:19:51 +01:00
Reza Rezvani
706da0250c docs(claude): refactor CLAUDE.md into modular documentation structure
- Refactor main CLAUDE.md from 491 to 164 lines (66% reduction)
- Create 9 domain-specific CLAUDE.md files for focused guidance:
  * agents/CLAUDE.md (347 lines) - Agent development guide
  * marketing-skill/CLAUDE.md (253 lines) - Marketing tools
  * product-team/CLAUDE.md (268 lines) - Product management tools
  * engineering-team/CLAUDE.md (291 lines) - Engineering tools
  * standards/CLAUDE.md (176 lines) - Standards usage
  * c-level-advisor/CLAUDE.md (143 lines) - Strategic advisory
  * project-management/CLAUDE.md (139 lines) - Atlassian integration
  * ra-qm-team/CLAUDE.md (153 lines) - RA/QM compliance
  * templates/CLAUDE.md (77 lines) - Template system
- Add navigation map in main CLAUDE.md for easy domain access
- Create PROGRESS.md for real-time sprint tracking
- Implement auto-documentation system for sprint progress

Benefits:
- Main CLAUDE.md now concise and navigable
- Domain-specific guidance easier to find
- No duplicate content across files
- Better organization for 42 skills across 6 domains

Total: 2,011 lines across 10 organized files vs 491 lines in 1 monolithic file

Sprint: sprint-11-05-2025
Issue: Part of documentation refactoring milestone
2025-11-05 12:44:03 +01:00
Reza Rezvani
e8af39aed6 feat(foundation): create directory structure and standards library
- Create root-level directories: agents/, commands/, standards/, templates/
- Port 5 core standards from global Claude standards
- Adapt standards for claude-skills context (cs-* prefix, Python tools, skills)
- Create sprint planning documents (context.md, plan.md)
- All directories tracked with .gitkeep files

Standards created:
- communication-standards.md (absolute honesty, zero fluff, pragmatic focus)
- quality-standards.md (Python tool quality, agent workflows, testing)
- git-workflow-standards.md (conventional commits, semantic versioning)
- documentation-standards.md (Markdown standards, living docs, templates)
- security-standards.md (secret detection, dependency security, input validation)

Sprint plan ready for Days 1-6 implementation.

Phase: 1 (Foundation)
Issues: #8, #9
2025-11-05 11:37:53 +01:00