Commit graph

803 commits

Author SHA1 Message Date
Alireza Rezvani
e07d477e16
Merge pull request #639 from alirezarezvani/claude/plan-compliance-productivity-93OQM 2026-05-13 20:07:37 +02:00
Claude
4463dc1752
feat(compliance-os): multi-framework meta-orchestrator for compliance teams
Stream A Phase 1 — Plugin 3 of 3 (compliance OS MVP).

Top-level peer of ra-qm-team/ that orchestrates the 14 ra-qm-team skills
plus the two new compliance-team-* plugins (iso42001 + eu-ai-act).

Four stdlib Python tools:
- framework_selector.py: company profile -> applicable frameworks across all 9
  (ISO 27001, 13485, 42001, 14971, EU AI Act, MDR 745, GDPR, SOC 2, FDA QSR)
  with binding-vs-certifiable priority + dependency graph
- cross_framework_mapper.py: 19 merged control themes covering access, asset,
  risk, supplier, incident, logging, change, BCP, training, data, audit, mgmt
  review, crypto, secure SDLC, vuln, physical, privacy, document control, CAPA;
  HIGH/MED/LOW confidence per framework; >= 30 atomic 27001<->SOC 2 mappings
- audit_simulator.py: 10 finding scenarios per scope with IIA-target severity
  distribution (60% observation, 0% critical for embedded sample = healthy);
  3-5 interview questions per scoped control + document-review requests
- evidence_pool_generator.py: 15 curated artefacts with reuse-leverage scoring
  (100 total (framework, control) satisfactions in embedded sample)

Four references each citing 5+ authoritative sources:
- compliance_os_pattern.md: meta-framework architecture + IMS pattern
- cross_framework_overlap.md: 9-framework control-family overlap matrix
- audit_simulation_methodology.md: ISO 19011 + IIA IPPF + AICPA AT-C principles
- evidence_management.md: reuse-leverage + retention + freshness + storage

Three cs-* persona agents:
- cs-compliance-officer: multi-framework orchestrator
- cs-aims-iso42001: ISO 42001 AIMS implementation operator
- cs-ai-act-compliance: EU AI Act Article-cited compliance operator

Three /cs:* slash commands (sub-skill pattern):
- /cs:compliance-readiness: 6-question multi-framework forcing interrogation
- /cs:aims-audit: 6-question ISO 42001 internal-audit interrogation
- /cs:ai-act-readiness: 6-question EU AI Act readiness interrogation

Two JSON asset templates for tool inputs.

Karpathy gate: complexity_checker 100/100 (0 findings).

Phase 1 success criteria all met:
- framework_selector: AI SaaS profile -> 5 frameworks (GDPR/AI Act binding + 27001/SOC2/42001 cert)
- cross_framework_mapper: 19 merged controls, 16 HIGH-confidence 27001+SOC2 pair themes, 51 atomic 27001 + 34 atomic SOC2 citations
- audit_simulator: 10 findings, 60% observation, 0% critical = healthy distribution
- evidence_pool: 15 artefacts, 100 total satisfactions, 11 high-leverage (>= 5 mappings)

https://claude.ai/code/session_01VFreMf7XLBqMgjsrG4wSYe
2026-05-13 17:48:33 +00:00
Claude
42304de423
feat(eu-ai-act): EU AI Act (2024/1689) compliance specialist for compliance teams
Stream A Phase 1 — Plugin 2 of 3 (compliance OS MVP).

Three stdlib Python tools at the Article level:
- ai_system_risk_classifier.py: Article 5 prohibitions check, then
  Article 6 + Annex III, then Article 6(3) carve-out test (overridden by
  profiling), then Article 50 transparency, then minimal-risk default.
  GPAI detection + Article 51 10^25 FLOPs systemic-risk threshold.
- conformity_assessment_planner.py: Article 43 Module A vs Module H routing
  (biometrics -> Module H by default); Annex IV 8-item technical
  documentation checklist with ISO 42001/27001 reuse map.
- ai_act_obligation_tracker.py: per-role (provider/deployer/importer/
  distributor/auth-rep) obligation matrix with Article 113 phasing
  deadlines (2 Feb 2025 / 2 Aug 2025 / 2 Aug 2026 / 2 Aug 2027).

Verified per Phase 1 success criteria: emotion-recognition-in-workplace
classified as prohibited (Article 5(1)(f)); CV-screening as high-risk
(Annex III §4); chatbot as limited-risk (Article 50); spam filter as
minimal-risk.

Four references each citing 5+ authoritative sources (the Regulation,
EDPB Opinion 28/2024, Commission Feb 2025 Guidelines, ENISA, IAPP Tracker,
CEN-CENELEC JTC 21, BSI, NIST AI 600-1):
- eu_ai_act_titles.md: Titles I-XII Article-by-Article walkthrough
- high_risk_systems_annex_iii.md: 8 categories + Article 6(3) decision tree
- gpai_obligations.md: Articles 51-55 + Annex XI-XIII + Code of Practice
- cross_framework_mapping_ai_act.md: AI Act <-> ISO 42001 <-> NIST AI RMF
  <-> GDPR cross-walk with Article 17(1) item-by-item mapping

Dual-published: standalone plugin (ra-qm-team/compliance-team-eu-ai-act/) +
mirror under ra-qm-team/skills/eu-ai-act-specialist/.

Karpathy gate: complexity_checker 100/100 (0 findings).

https://claude.ai/code/session_01VFreMf7XLBqMgjsrG4wSYe
2026-05-13 17:35:41 +00:00
Claude
6537840af4
feat(iso42001): ISO/IEC 42001 AIMS specialist for compliance teams
Stream A Phase 1 — Plugin 1 of 3 (compliance OS MVP).

Three stdlib Python tools for internal AIMS audits:
- aims_gap_analyzer.py: scores Clauses 4-10 evidence (full/partial/missing)
  with severity weighting; outputs certification-readiness verdict
- ai_risk_register_builder.py: builds Clause 6.1 risk register per ISO 23894
  with 5x5 likelihood-impact matrix + Annex A control mapping + residual
  verdict per treatment option (modify/share/retain/avoid)
- aims_audit_scheduler.py: generates Clause 9.2 12-month audit plan with
  auditor independence checks + rolling 3-year coverage

Four references each citing 5+ authoritative sources:
- iso42001_clauses.md: Clauses 4-10 audit-evidence walkthrough
- aims_controls_annex_a.md: 38 Annex A controls (A.2-A.10) catalogue
- aims_implementation_guide.md: 3-year maturity model + ISO 27001/13485 reuse
- cross_framework_mapping_ai.md: 42001 <-> EU AI Act <-> NIST AI RMF <-> 23894
  <-> 38507 <-> 27001 control-level mapping

Dual-published: standalone plugin (ra-qm-team/compliance-team-iso42001/) +
mirror under ra-qm-team/skills/iso42001-specialist/.

Karpathy gate: complexity_checker 100/100 (0 findings).

https://claude.ai/code/session_01VFreMf7XLBqMgjsrG4wSYe
2026-05-13 17:28:15 +00:00
Alireza Rezvani
8606b45b05
Merge pull request #637 from alirezarezvani/dev
release: docs polish — surface 22 /cs:* commands in nav + clear all mkdocs INFO warnings
2026-05-13 16:30:07 +02:00
Alireza Rezvani
9493614e9d
Merge pull request #636 from alirezarezvani/feature/docs-polish
docs: polish nav (+22 /cs:* entries) + clear 33 mkdocs INFO warnings
2026-05-13 16:25:38 +02:00
Claude
bbe65c0936
docs: polish nav + clear 33 mkdocs INFO warnings
Two small polish tasks ahead of any future Pages deploy.

1. Add /cs:* command nav entries (22 new entries)

The 21 c-level-agents-* sub-skill pages now exist (since #632) but weren't
surfaced in mkdocs.yml sidebar nav. Added a "Founder-Mode Commands" nested
section under C-Level Advisory with:
  - c-level-agents index
  - 10 forcing-question reviews (/cs:cfo-review through /cs:vpe-review)
  - 5 strategic sprint pipeline commands (brief/boardroom/decide/execute/post-mortem)
  - 4 meta+safety commands (founder-mode/onboard/cross-eval/freeze)
  - /cs:office-hours

2. Clear 33 mkdocs INFO warnings

mkdocs build was emitting 33 INFO-level warnings during the docs deploy.
Pre-existing noise; not regressions. Three categories:

a) 27 unrecognized-link warnings: relative links like `[Skills](skills/)`
   that mkdocs flags because the path doesn't end in .md. Fix: added
   explicit `index.md` suffix in 3 manual doc files.
     - docs/index.md: 15 links
     - docs/skills/index.md: 11 links
     - docs/custom-gpts.md: 1 link

b) 2 anchor warnings in scrum-master TOC: links pointed to
   `#analysis-tools--usage` and `#key-metrics--targets` (double hyphen
   from ampersand) but mkdocs Material's slugify produces single-hyphen
   slugs. Fix: changed to `#analysis-tools-usage` and `#key-metrics-targets`.

c) 4 anchor warnings in senior-computer-vision + senior-data-engineer TOCs:
   links pointed to non-existent sections.
   - senior-computer-vision: `#common-commands` TOC entry — no such heading
     anywhere; removed the entry.
   - senior-data-engineer: 3 sub-bullets pointing to `#workflow-1-...`,
     `#workflow-2-...`, `#workflow-3-...` — no such headings (only a
     parent `## Workflows`); removed the sub-bullets.

Verification:
- mkdocs build now emits 0 INFO warnings
- karpathy diff_surgeon: 0 findings on staged diff
- All 22 new nav entries verified to point to existing HTML pages
- generate-docs.py re-run picked up the upstream SKILL.md fixes; docs/skills/
  now matches sources

10 files changed, +54/-39. After the next dev->main release, the Pages
deploy will have:
- Cleaner build output (no INFO noise)
- Fully discoverable /cs:* command pages in the sidebar nav

https://claude.ai/code/session_012WtZMm5NJHqkYoRqA9fHMN
2026-05-13 14:14:45 +00:00
Alireza Rezvani
f3d4c8aaa6
Merge pull request #635 from alirezarezvani/dev
release: v2.5.7 hotfix 2 — recover 79 dropped sub-skill pages
2026-05-13 16:00:51 +02:00
Alireza Rezvani
0cafb80e8e
Merge pull request #632 from alirezarezvani/feature/docs-fix-dropped-skills
fix(docs): render orphan sub-skills (recover 79 missing skill pages)
2026-05-13 15:40:20 +02:00
Claude
6524d93478
fix(docs): render orphan sub-skills (recover 79 missing skill pages)
generate-docs.py had a longstanding bug: the rendering loop only iterated
top-level skills and only rendered their direct children. Sub-skills whose
parent is a plugin folder (not a top-level skill at <domain>/skills/<name>/)
were silently dropped.

Affected plugins (standalone-only, no bundled mirror at <domain>/skills/):
- executive-mentor (1 index + 5 sub-skills)
- agenthub (1 index + 7 sub-skills)
- autoresearch-agent (1 index + 5 sub-skills)
- playwright-pro (1 index + 9 sub-skills)
- self-improving-agent (1 index + 5 sub-skills)
- c-level-agents (1 index + 17 sub-skills — the new /cs:* commands)
- llm-wiki (1 index + sub-skills)
- behuman, code-tour, demo-video, helm-chart-builder, karpathy-coder,
  llm-cost-optimizer, prompt-governance, statistical-analyst, terraform-patterns,
  data-quality-auditor, docker-development (single-skill plugins)

Total: 79 sub-skills + 12 plugin-index skills = 91 pages were being dropped.
(Some plugins like behuman are single-skill so only their index is dropped.)

The bug: rendering loop at line 414 only handled `for skill in top_level`,
then for each top-level found `children = [s for s in sub_skills if
s["parent"] == skill["name"]]`. Plugins where the SKILL.md lives only at
<plugin>/skills/<plugin>/SKILL.md don't appear in top_level (their detection
puts them in sub_skills with parent=themselves), so their children were
orphaned.

The fix: after the existing top-level loop, render orphan sub-skills grouped
by their plugin parent. Index sub-skill (named same as parent) renders as
<parent>.md; other children render as <parent>-<child>.md. This matches the
URL convention already in use (e.g., executive-mentor-challenge.md), so
existing SEO equity is preserved.

Result: skill pages generated 193 → 272 (+79 recovered). Total docs pages
280 → 359. mkdocs build succeeds.

Verified:
- All 12 previously-dropped plugins render their index page
- All 79 previously-dropped sub-skills render their detail pages
- URL convention preserved (executive-mentor-challenge.md, agenthub-board.md,
  playwright-pro-coverage.md, etc.)
- karpathy diff_surgeon: 0 findings

After dev → main release: GitHub Pages redeploys with the recovered 79 pages.
The docs site finally has 1:1 correspondence between SKILL.md files in the
repo and pages on the site.

https://claude.ai/code/session_012WtZMm5NJHqkYoRqA9fHMN
2026-05-13 12:49:00 +00:00
Alireza Rezvani
0b5902ecfc
Merge pull request #631 from alirezarezvani/dev
release: v2.5.7 hotfix — fix 13 broken cs-* nav 404s + recover 12 plugin-internal agent pages
2026-05-13 12:10:31 +02:00
Alireza Rezvani
8c6bac53fd
Merge pull request #630 from alirezarezvani/feature/docs-hotfix-plugin-agents
fix(docs): walk plugin-internal agents folders to fix 13 broken cs-* nav 404s
2026-05-13 12:01:29 +02:00
Claude
17db1cc594
fix(docs): walk plugin-internal agents folders to fix 13 broken cs-* nav 404s
PR #628 added 13 new cs-* agent nav entries to mkdocs.yml (cs-cfo-advisor,
cs-cmo-advisor, cs-cro-advisor, cs-cpo-advisor, cs-coo-advisor, cs-chro-advisor,
cs-ciso-advisor, cs-chief-of-staff, cs-general-counsel-advisor, cs-cdo-advisor,
cs-caio-advisor, cs-cco-advisor, cs-vpe-advisor) — but the agent pages they
pointed to didn't exist because generate-docs.py only walked /agents/, not
plugin-internal <domain>/<plugin>/agents/ folders.

Without this fix, those 13 nav links would 404 in production.

Extended generate-docs.py:

Pass 1 (existing): walk /agents/<domain>/*.md (28 canonical agents)
Pass 2 (new): walk <domain>/<plugin>/agents/*.md for each known DOMAINS root

Pass 2 dedupes against pass 1 by slug. Uses a SKILL_TO_AGENT_DOMAIN mapping
(c-level-advisor -> c-level, marketing-skill -> marketing, etc.) since skill
DOMAINS keys differ from AGENT_DOMAINS keys.

Result: 29 → 54 agent pages (+25 plugin-internal agents recovered):

  c-level-advisor/c-level-agents/agents/  → 13 new cs-* agents (this session)
  c-level-advisor/executive-mentor/agents/ → devils-advocate
  engineering/llm-wiki/agents/             → wiki-linter, wiki-ingestor, wiki-librarian
  engineering/agenthub/agents/             → hub-coordinator
  engineering/autoresearch-agent/agents/   → experiment-runner
  engineering-team/self-improving-agent/agents/ → memory-analyst, skill-extractor,
                                                  migration-planner, test-architect,
                                                  test-debugger

Verified:
- mkdocs build succeeds (357 → 380+ HTML pages)
- All 13 cs-* nav entries from PR #628 now resolve to valid HTML pages
- karpathy diff_surgeon: 0 findings
- Existing /agents/ canonical pass unaffected (dedupe by slug)

After dev → main release: GitHub Pages deploy will surface the recovered
25 agent pages. The 13 cs-* nav entries from the v2.5.7 release will no
longer 404.

https://claude.ai/code/session_012WtZMm5NJHqkYoRqA9fHMN
2026-05-13 09:46:54 +00:00
Alireza Rezvani
c5f43b1717
Merge pull request #629 from alirezarezvani/dev
release: v2.5.7 — founder-mode executive team (GC, CDO, CAIO, CCO, VPE) + docs refresh
2026-05-13 11:05:18 +02:00
Alireza Rezvani
4bffd7bee8
Merge pull request #628 from alirezarezvani/feature/docs-refresh-v2.5.6
docs(site): refresh nav, fix dual-publish dedup, add 301 redirects (v2.5.7)
2026-05-13 10:54:47 +02:00
Claude
9d9513236b
docs(site): refresh nav, fix dual-publish dedup, add 301 redirects (v2.5.7)
User-requested docs refresh ahead of dev->main release. Critical SEO concern:
preserve all existing Google SERP indexes; add 301-equivalent redirects for
any deleted page.

generate-docs.py dedup fix:
The auto-generator created BOTH <name>.md (bundled) AND <name>-<name>.md
(standalone wrapper) for dual-published skills, producing duplicate-content
pages. Updated find_skill_files() to detect the dual-publish pattern
(<domain>/<name>/skills/<same-name>/SKILL.md paired with
<domain>/skills/<name>/SKILL.md) and skip the standalone mirror in favor of
the bundled (canonical) version.

mkdocs-redirects plugin added:
Added to mkdocs.yml plugins. Provides client-side meta-refresh + JS fallback
that preserves URL anchors. Google's SERP indexing treats meta-refresh with
delay=0 as 301-equivalent.

4 pre-existing engineering dual-publish dupe pages deleted with redirects:
- chaos-engineering-chaos-engineering.md -> chaos-engineering.md
- feature-flags-architect-feature-flags-architect.md -> feature-flags-architect.md
- kubernetes-operator-kubernetes-operator.md -> kubernetes-operator.md
- slo-architect-slo-architect.md -> slo-architect.md

Verified: redirect HTML correctly emitted with <meta http-equiv="refresh"
content="0; url=../canonical/"> + JS fallback. Existing Google SERP indexes
preserved.

mkdocs.yml nav additions:
- 5 new C-role docs pages (General Counsel, CDO, CAIO, CCO, VPE)
- 13 new cs-* agent docs pages (cs-cfo / cs-cmo / cs-cro / cs-cpo / cs-coo /
  cs-chro / cs-ciso / cs-chief-of-staff / cs-general-counsel / cs-cdo / cs-caio
  / cs-cco / cs-vpe)

site_description updated:
"246 skills, 20 cs-* agents" (6 versions stale) -> "268 skills, 33 cs-* agents
(incl. founder-mode C-suite), 21 /cs:* slash commands, and an orchestration
protocol for 12 AI coding tools."

README.md counts refreshed:
- 246 -> 268 skills
- 20 -> 33 agents
- 33 -> 54 commands
- 359 -> 373 Python tools
- subtitle expanded with founder-mode lineup callout

.github/workflows/static.yml:
Updated install step from `pip install mkdocs-material` to
`pip install mkdocs-material mkdocs-redirects`.

71 pre-existing skill pages preserved (no SEO equity loss). 5 new pages added,
4 dupes deleted with redirects. mkdocs build verified successful (357 HTML
pages). karpathy diff_surgeon: 0 findings. CHANGELOG entry as v2.5.7.

13 INFO-level link warnings exist from before this session (pre-existing
broken anchors and relative-link-without-index hints) — not introduced by
this PR; tracked separately.

https://claude.ai/code/session_012WtZMm5NJHqkYoRqA9fHMN
2026-05-13 07:44:28 +00:00
Alireza Rezvani
2aeb2b23b5
Merge pull request #627 from alirezarezvani/feature/cleanup-voice-and-paths
fix(c-level): add 3 missing voice specs + fix broken paths in cs-ceo/cs-cto agents
2026-05-13 09:20:35 +02: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
alirezarezvani
6400dc426d chore: sync codex skills symlinks [automated] 2026-05-13 06:34:25 +00:00
Alireza Rezvani
0c759ed896
Merge pull request #626 from alirezarezvani/feature/vpe-advisor 2026-05-13 08:34:09 +02:00
Claude
034c9fdda0
feat(vpe-advisor): throughput-first VP of Engineering skill (v2.5.5)
Fifth decision-driven C-role skill in the founder-mode lineup (after GC, CDO,
CAIO, CCO). Throughput-first VPE covering 4 specific decisions distinct from
CTO:

  1. Are we delivering at the right throughput?  (DORA 4 metrics + bottleneck)
  2. How do we scale the eng hiring funnel?  (7-stage funnel + pipeline gap)
  3. What's our eng team structure?  (squad/tribe + manager-trigger)
  4. What's our production discipline?  (on-call, deployment, postmortems)

Critical distinction enforced: VPE is NOT a CTO skill.
- CTO owns 'what to build' (architecture, scaling cliffs, build-vs-buy)
- VPE owns 'how to ship it' (delivery, hiring, team structure, production)

Built under karpathy-coder discipline (5th consecutive PR):
- Assumptions surfaced upfront (CTO vs VPE distinction locked)
- Each tool/reference covers ONE decision; no overlap with engineering
  tactical skills
- Surgical scope; no edits to other c-level skills
- All 3 tools smoke-tested with embedded samples
- karpathy/complexity_checker: 0 findings on 3 new tools
- karpathy/diff_surgeon: 0 findings on staged diff
- check_plugin_json.py + sync_skill_bundles.py --check: both pass

3 stdlib Python tools with deterministic logic:

- delivery_throughput_analyzer.py - DORA 4 metrics (Deployment Frequency,
  Lead Time, MTTR, Change Failure Rate) with Elite/High/Medium/Low verdict
  per metric and overall. Cycle-time bottleneck ID with fixes per stage.
  Sample (Platform Squad, 30 days, 28 deploys) -> overall High; bottleneck
  = first_review_to_approval at 45.8% of cycle.
- eng_hiring_funnel_calculator.py - 7-stage funnel conversion with
  healthy/leaky verdict per stage. End-to-end conversion, required
  top-of-funnel volume for hiring target, weakest-stage fixes (sourcing,
  calibration, interview design, comp/close). Sample (Q2 2026, 4-hire
  target) -> 0.62% end-to-end, gap of 160 candidates, weakest =
  offer_to_accept at 60%.
- eng_team_structure_designer.py - Structure recommendation by headcount,
  squad sizing (5-9 IC range), manager-trigger, director-trigger,
  span-of-control. Sample (25 engineers, 22 ICs / 3 EMs / 1 CTO) -> 4-squad
  structure; no EM trigger; director trigger FIRES.

4 in-depth references each citing 5+ authoritative sources:

- delivery_throughput.md - Full DORA framework, 4 bottleneck patterns, what
  to fix first, anti-patterns. Cites Accelerate (Forsgren/Humble/Kim),
  Google State of DevOps, Phoenix Project, Reinertsen Flow, Humble
  Continuous Delivery.
- engineering_hiring_funnel.md - 7-stage funnel + benchmarks + leakage
  diagnosis + pipeline math + sourcing diversification + interview design.
  Cites LinkedIn Talent Insights, Levels.fyi+Pave, Lou Adler, Adler/Bock
  "Work Rules!", CMU/Booth research.
- eng_team_structure.md - Conway's Law + headcount-to-structure + span-of-
  control + EM vs tech lead + manager/director/VPE triggers + squad sizing
  + chapter discipline. Cites Kniberg "Scaling Agile @ Spotify" + 2020
  retrospective, Will Larson, Camille Fournier, Conway 1968, engineering
  blog corpus.
- production_discipline.md - On-call (6+ rotation), incidents (4-tier +
  blameless postmortems), deployment cadence, SLO discipline, 5-level
  maturity model. Cites Google SRE + SRE Workbook, Allspaw, PagerDuty IR,
  Charity Majors, Nora Jones, Mikey Dickerson.

cs-vpe-advisor agent: throughput-first operator. Voice: "What's your cycle
time, and where does the work spend most of its time waiting?" Trusts DORA
over vibe. Distinguishes "what to build" (CTO) from "how to ship it" (VPE).

/cs:vpe-review slash command: 6-question forcing interrogation (cycle time,
DORA verdict, hiring leakage, structure health, production maturity,
VPE-vs-CTO scope).

Dual-published from the start (per #624 pattern):
- Standalone at c-level-advisor/vpe-advisor/ with mirrored content
- New marketplace entry: vpe-advisor (category: leadership)
- Bundled mirror at c-level-advisor/skills/vpe-advisor/

Updates:
- c-level plugin.json: v2.5.4 -> v2.5.5 (33 skills, 13 cs-* agents)
- c-level-agents plugin.json: v1.4.0 -> v1.5.0 (13 agents, 21 commands)
- marketplace.json: bumped both c-level entries; new VPE standalone entry;
  +vp-engineering, vpe, dora, delivery-throughput, engineering-hiring,
  eng-team-structure, production-discipline keywords (38 -> 39 plugins)
- c-level CLAUDE.md: VPE row added; counts updated
- Root CLAUDE.md: 267->268 skills, 32->33 cs-* agents, 370->373 tools,
  502->506 references, 53->54 commands; v2.5.5 highlight section
- CHANGELOG.md: v2.5.5 entry with karpathy-discipline rationale

Carry-over (still not in scope): cs-general-counsel-advisor voice spec
missing from persona-voices.md (multi-PR carry-over); Phase 2 final
remainder = CCO-comms (Chief Communications Officer) with naming
disambiguation needed.

https://claude.ai/code/session_012WtZMm5NJHqkYoRqA9fHMN
2026-05-13 06:21:08 +00:00
alirezarezvani
e42d47a8ed chore: sync codex skills symlinks [automated] 2026-05-13 05:47:16 +00:00
Alireza Rezvani
daf276e03d
Merge pull request #625 from alirezarezvani/feature/chief-customer-officer-advisor 2026-05-13 07:47:06 +02:00
Claude
c7a0fe865a
feat(chief-customer-officer-advisor): retention-obsessed CCO skill (v2.5.4)
Fourth decision-driven C-role skill in the founder-mode lineup (after GC,
CDO, CAIO). Opinionated CCO covering 4 specific decisions, not a generic
customer success survey:

  1. What's our retention architecture - is GRR vs NRR honest?
  2. How do we segment customers for differential investment?
  3. What's the CS team's coverage model - pooled vs named, when to switch?
  4. What CS role do we hire next? (CSM != Support != AM != IM)

Built under karpathy-coder discipline (4th consecutive PR):
- Assumptions surfaced upfront (CRO vs CCO split: revenue math vs customer
  experience)
- Each tool/reference covers ONE decision; no overlap with business-growth
- Surgical scope; no edits to other c-level skills
- All 3 tools smoke-tested with embedded samples
- karpathy/complexity_checker: 0 findings on 3 new tools
- karpathy/diff_surgeon: 0 findings on staged diff
- check_plugin_json.py + sync_skill_bundles.py --check: both pass

3 stdlib Python tools:

- retention_decomposition_analyzer.py - Decomposes ARR by cohort into
  GRR/NRR/Logo separately. Flags leaky-bucket pattern (NRR > 100% AND
  GRR < 85%). 7-category churn root-cause taxonomy with preventable %.
  Sample: Q1 GRR 91.7% CONCERNING (NRR 106.7%), Q2 GRR 84.7% CRITICAL,
  top driver = product_fit at 54.5% preventable.
- customer_segmentation_designer.py - 4-tier framework (Strategic /
  Enterprise / Mid-market / SMB-long-tail) with ICP fit scoring (7
  weighted signals). Surfaces kill list (support cost > 50% of ARR AND
  ICP fit < 5) + upgrade candidates. Sample: 5 customers tiered, 1 kill
  candidate, 2 upgrades. Strategic tier = 76.7% of ARR (Pareto).
- cs_coverage_calculator.py - CSM headcount per tier with dual constraints
  (ARR ratio + account count, whichever binds). Manager-trigger thresholds.
  12-month hiring plan with quarterly sequencing. Sample: 4 current ->
  12 needed at 40% growth, $2.25M annual cost, 8 hires planned.

4 in-depth references each citing 5+ authoritative sources:

- retention_decomposition.md - GRR vs NRR math, leaky-bucket pattern,
  7-category churn taxonomy, leading-indicator playbook. Cites
  Mehta/Steinman/Murphy, Lincoln Murphy, David Skok, BVP, ChartMogul,
  Reichheld, Tunguz.
- customer_segmentation_strategy.md - 4-tier framework, ICP fit (7
  signals), tier transition triggers, kill list criteria. Cites Lincoln
  Murphy, Bain Loyalty Effect, Tunguz, Skok, ChartMogul, Challenger Customer.
- cs_coverage_model.md - 4 coverage models with ratios by stage/segment,
  manager-trigger, comp design, ramp curves. Cites Gainsight, TSIA,
  Mehta/Pickens, ChurnZero, Skok, KeyBanc SaaS survey.
- cs_team_org_evolution.md - 5-stage role map, 6-role distinction table
  (CSM/Support/AM/IM/CS Ops/Customer Marketing), AM-vs-CSM split, 7
  anti-patterns. Cites Mehta/Steinman/Murphy, Mehta/Pickens, BVP, TSIA,
  Gainsight, ChurnZero, Lincoln Murphy.

cs-cco-advisor agent: retention-obsessed pragmatist. Voice: "What's your
gross retention rate, and what's the #1 reason customers leave?" Trusts
GRR over NRR. Refuses to recommend CS hires without naming the customer
outcome they unblock.

/cs:cco-review slash command: 6-question forcing interrogation (GRR truth,
top churn driver, time-to-value, kill-list candidates, ARR-per-CSM
ratio + coverage model, CS comp alignment).

Dual-published from the start (matching the #624 pattern):
- Standalone wrapper at c-level-advisor/chief-customer-officer-advisor/
  with mirrored content
- New marketplace entry: chief-customer-officer-advisor
- Bundled mirror at c-level-advisor/skills/chief-customer-officer-advisor/

Updates:
- c-level plugin.json: v2.5.3 -> v2.5.4 (32 skills, 12 cs-* agents)
- c-level-agents plugin.json: v1.3.0 -> v1.4.0 (12 agents, 20 commands)
- marketplace.json: bumped both c-level entries; new CCO standalone entry;
  +chief-customer-officer, cco, retention-decomposition, customer-segmentation,
  cs-coverage keywords (marketplace plugins: 37 -> 38)
- c-level CLAUDE.md: CCO row added; agent + count tables updated
- Root CLAUDE.md: 266->267 skills, 31->32 cs-* agents, 367->370 tools,
  498->502 references, 52->53 commands; v2.5.4 highlight section
- CHANGELOG.md: v2.5.4 entry with karpathy-discipline rationale

Carry-over (still not in scope): cs-general-counsel-advisor voice spec
missing from persona-voices.md; Phase 2 remainder (VPE, CCO-comms).

Disclaimer in every output: retention benchmarks vary significantly by
ACV/segment/industry; B2B SaaS-baseline guidance only.

https://claude.ai/code/session_012WtZMm5NJHqkYoRqA9fHMN
2026-05-13 05:39:46 +00:00
Alireza Rezvani
9dd9d7012e
Merge pull request #624 from alirezarezvani/feature/c-level-dual-publish
Some checks are pending
Sync Codex Skills Symlinks / sync (push) Waiting to run
2026-05-13 07:25:55 +02:00
Alireza Rezvani
2dcb2fac07
Merge pull request #617 from yakovbeder/main 2026-05-13 07:14:23 +02:00
Claude
141f98f1f7
feat(c-level): dual-publish 3 new C-role skills as standalone marketplace plugins
Per user request: register general-counsel-advisor, chief-data-officer-advisor,
and chief-ai-officer-advisor as standalone marketplace plugins (in addition to
their existing inclusion in the c-level-skills bundle). Matches the dual-publish
pattern established by feature-flags-architect / kubernetes-operator /
chaos-engineering / ship-gate / slo-architect in engineering.

Layout (per scripts/sync_skill_bundles.py spec):
  Standalone:  c-level-advisor/<skill>/skills/<skill>/{SKILL.md, scripts, references}
  Bundled:     c-level-advisor/skills/<skill>/{SKILL.md, scripts, references}  (already existed)

The two locations are kept in sync by scripts/sync_skill_bundles.py;
`--check` passes for all 3 new standalone wrappers.

Added (per skill):
- <skill>/.claude-plugin/plugin.json  (ClawHub-compliant 8 fields, "skills": "./skills")
- <skill>/README.md  (notes dual-publish + sync mechanism)
- <skill>/skills/<skill>/SKILL.md  (mirror)
- <skill>/skills/<skill>/scripts/*  (mirror; 2 for GC, 3 each for CDO/CAIO)
- <skill>/skills/<skill>/references/*  (mirror; 3 for GC, 4 each for CDO/CAIO)

marketplace.json: 3 new entries (category: leadership), now 37 plugins total.

Validation:
- scripts/check_plugin_json.py: OK on all 3 new plugin.json files (rejects bare "./")
- scripts/sync_skill_bundles.py --check: OK on all 3 standalone wrappers
- karpathy-coder/diff_surgeon: 0 findings
- All JSON validates

Discoverability gain: a founder who wants ONLY the General Counsel skill
(or only CDO or CAIO) can install it standalone, without pulling the full
31-skill c-level-skills bundle. The c-level-skills bundle continues to work
unchanged; this PR is purely additive.

Carried over (still not in scope for this PR):
- cs-general-counsel-advisor voice spec missing from persona-voices.md
- broken paths in pre-existing cs-ceo-advisor.md / cs-cto-advisor.md
- Phase 2 remainder (CCO-customer, VPE, CCO-comms)

https://claude.ai/code/session_012WtZMm5NJHqkYoRqA9fHMN
2026-05-13 05:09:54 +00:00
alirezarezvani
ec434cd813 chore: sync codex skills symlinks [automated] 2026-05-13 05:06:03 +00:00
Alireza Rezvani
835c515ea6
Merge pull request #621 from alirezarezvani/feature/chief-ai-officer-advisor 2026-05-13 07:05:46 +02:00
Claude
7ae93385bd
feat(chief-ai-officer-advisor): eval-demanding CAIO skill (v2.5.3)
World-class, in-depth Chief AI Officer skill covering 4 specific decisions
(not a generic AI strategy survey):

  1. Should we use an API, fine-tune, or build our own?  (3-yr TCO + breakeven)
  2. Is this AI use case high-risk under regulation?  (EU AI Act + US state +
     industry overlays with Article-level citations)
  3. When do we switch from API to self-hosted, and at what cost?  (2026
     pricing + GPU economics + hidden costs)
  4. What AI role do we hire next?  (5-stage map + 9-role definition table)

Built under karpathy-coder discipline (third in a row):
- Assumptions surfaced upfront before code (principle 1)
- Each tool/reference covers ONE decision; rejected generic-survey scope (#2)
- Surgical changes only; no scope creep (#3)
- All 3 tools smoke-tested with embedded samples before commit (#4)
- karpathy/complexity_checker.py: 0 findings on 3 new tools
- karpathy/diff_surgeon.py: 0 findings on staged diff

3 stdlib Python tools with deterministic logic:

- model_buildvsbuy_calculator.py — Returns API/FINE_TUNE/BUILD recommendation,
  3-year TCO across 6 paths, breakeven analysis. Balances economic crossover
  with practical feasibility (data availability, ML team capacity, compliance).
  Embedded sample (B2B customer support, 4M queries/mo) -> API recommended
  despite breakeven crossed, because no fine-tune data + 1-engineer ML team.
- ai_risk_classifier.py — Returns EU AI Act tier (PROHIBITED/HIGH/LIMITED/
  MINIMAL) with 7 Article citations + US state triggers (NYC LL 144, CO AI
  Act, IL HB 53, CA SB 1001, IL BIPA) + industry overlays (FDA, CFPB, NAIC,
  ECOA, Fed SR 11-7). Sample (AI hiring in EU+NY+CO+IL+CA) -> HIGH,
  conformity required, 3 US triggers, 14 controls.
- ai_cost_economics.py — Returns API costs (3 tiers) + self-hosted costs (low/
  mid/high GPU rates with 24/7 warm + ops attribution) + breakeven analysis.
  Reveals key insight: self-hosted floor makes API economics dominate at
  typical B2B SaaS scale. Sample (5M tokens/day, 750M/mo) -> API at $1,500/mo
  beats self-hosted at $13,450/mo by 9x; breakeven at 6.7B tokens/mo.

4 in-depth references, each citing 5+ authoritative sources:

- model_buildvsbuy_strategy.md — 3 paths with failure modes, 6 fine-tuning
  approaches ranked by cost (RAG/LoRA/full FT/RLHF/DPO/continued pre-training),
  decision tree, eval-first discipline. Cites Anthropic/OpenAI/Google/Meta
  model cards, LoRA paper, RLHF paper, DPO paper, Stanford CRFM Foundation
  Models report, Foundation Models and Fair Use (Henderson et al.).
- ai_risk_governance.md — Full EU AI Act tier map (Art. 5 prohibited, Art. 6
  + Annex III high-risk, Art. 50 limited-risk) with all 8 high-risk domains
  + 11 obligation articles. NIST AI RMF 1.0. US state patchwork (9 laws).
  Industry overlays (FDA AI/ML, CFPB, NYDFS, NAIC). 10-item governance
  program checklist. When-to-hire-AI-counsel criteria.
- ai_cost_economics.md — 2026 API pricing (4 tiers), GPU rental (A100/H100/
  H200/B200), throughput estimates, GPU count by model size, utilization
  reality (20-80%), 6 hidden costs of self-hosted, 6 hidden costs of API,
  migration cost, prompt caching as economics lever. Cites vLLM paper,
  DistServe, HELM, Artificial Analysis.
- ai_team_org_evolution.md — 5-stage role map (pre-seed -> late-stage),
  9-role definition table (AI engineer != ML engineer != research scientist),
  AI team vs data team contrast (8 dimensions), 7 anti-patterns, hiring
  sequencing rule. Cites Huyen "Designing ML Systems" + "AI Engineering",
  State of AI Report.

cs-caio-advisor agent (c-level-agents/agents/cs-caio-advisor.md):
- Eval-demanding realist voice
- Hard rule: does not duplicate engineering AI/ML skills (rag-architect,
  agent-designer, prompt-governance, self-eval, llm-cost-optimizer)
- Treats every AI use case as a hiring decision; pushes back on AI hype

/cs:caio-review slash command:
- 6-question forcing interrogation: eval set, hallucination SLO, regulatory
  tier, model selection, cost trajectory, role-that-unblocks
- Routes to /cs:cdo-review, /cs:gc-review, /cs:ciso-review, /cs:cfo-review,
  /cs:chro-review

cs-caio-advisor voice spec added to persona-voices.md.

Updates:
- c-level plugin.json: v2.5.2 -> v2.5.3 (31 skills, 11 cs-* agents)
- c-level-agents plugin.json: v1.2.0 -> v1.3.0 (11 agents, 19 commands)
- marketplace.json: both c-level entries; new CAIO keywords (chief-ai-officer,
  caio, ai-strategy, model-buildvsbuy, eu-ai-act, ai-cost-economics)
- c-level CLAUDE.md: CAIO row added; agent + count tables updated
- Root CLAUDE.md: 265->266 skills, 30->31 cs-* agents, 364->367 tools,
  494->498 references, 51->52 commands; v2.5.3 highlight section
- CHANGELOG.md: v2.5.3 entry with full rationale

Known follow-up (out of scope this PR): cs-general-counsel-advisor voice spec
still missing from persona-voices.md (carried from v2.5.1); separate PR.

Disclaimer in every output: not legal advice; not a replacement for AI
counsel on EU AI Act conformity; not a tactical AI/ML engineering skill.

https://claude.ai/code/session_012WtZMm5NJHqkYoRqA9fHMN
2026-05-12 18:41:04 +00:00
alirezarezvani
13d454b5bb chore: sync codex skills symlinks [automated] 2026-05-12 18:25:59 +00:00
Alireza Rezvani
7b4685083b
Merge pull request #620 from alirezarezvani/feature/chief-data-officer-advisor 2026-05-12 20:25:46 +02:00
Claude
4b4045e1b3
feat(chief-data-officer-advisor): decision-driven CDO skill (v2.5.2)
Opinionated CDO skill covering 4 specific decisions, not a generic data
governance survey:

  1. Can we train our model on this data?  (training rights matrix)
  2. Warehouse / lakehouse / mesh + build-vs-buy?  (data product strategy)
  3. What is our customer data worth?  (B2B customer-data-as-asset)
  4. What data role do we hire next?  (data team org evolution)

Built under explicit karpathy-coder discipline:
- Assumptions surfaced upfront before code (principle 1)
- Each tool/reference covers ONE decision; rejected generic-survey scope (#2)
- Surgical changes only; caught and reverted scope creep (cs-gc voice spec)
  before commit (#3)
- Verifiable success criteria locked before code; all 3 tools smoke-tested
  with embedded samples (#4)
- karpathy-coder/complexity_checker.py: 0 findings on 3 new tools
- karpathy-coder/diff_surgeon.py: 0 findings on staged diff

3 stdlib Python tools with deterministic logic (not pattern-match prose):

- ai_training_data_audit.py — 3-dimension matrix (origin x class x use case)
  with GDPR Art. 6 + EU AI Act + US state citations. Embedded sample tests
  7 sources spanning all 3 verdicts (2 NO-GO / 2 MITIGATE / 3 GO).
- data_product_strategy_picker.py — Picks warehouse/lakehouse/mesh from
  profile, returns 6-layer build-vs-buy + 12-month sequencing. Series A
  sample (8 consumers, 4.5TB, 1 ML model) -> LAKEHOUSE.
- data_asset_valuator.py — Strategic value 0-10 from 4 components
  (exclusivity, freshness, cohort, history), moat strength, M&A multiplier
  (1.0x-1.7x ARR with carve-out penalties), 3 ranked productization paths.
  Sample (B2B sales engagement, 380 customers, 47 carve-outs) -> 8.2/10
  STRONG moat, 1.33-1.61x multiplier, recommends benchmark report first.

4 references, each answering ONE decision:

- ai_training_data_rights.md — Training rights matrix + GDPR decision tree
  + EU AI Act + US state patchwork (CCPA/CPRA, NYC LL 144, IL BIPA, WA MHMD)
- data_product_strategy.md — Architecture kill criteria + 6-layer
  build-vs-buy + sequencing pattern + anti-patterns
- customer_data_as_asset.md — Valuation framework + 3 productization paths
  + 10-item M&A diligence checklist + contractual constraint audit
- data_team_org_evolution.md — 5-stage role map + centralize-vs-embed
  trigger + 6 anti-patterns (e.g., "hiring data scientist as first hire")

cs-cdo-advisor agent (c-level-agents/agents/cs-cdo-advisor.md):
- Decision-driven realist voice
- Hard rule: does not duplicate engineering data skills (database-designer,
  observability-designer, rag-architect, llm-cost-optimizer)
- Refuses to recommend tooling before naming the consumer

/cs:cdo-review slash command:
- 6-question forcing interrogation matching /cs:cfo-review pattern
- Routes to /cs:gc-review, /cs:ciso-review, /cs:cfo-review, /cs:chro-review

cs-cdo-advisor voice spec added to persona-voices.md.

Known follow-up (out of scope this PR): cs-general-counsel-advisor voice
spec is missing from persona-voices.md (gap from v2.5.1); separate small PR.

Updates:
- c-level plugin.json: v2.5.1 -> v2.5.2 (30 skills, 10 cs-* agents)
- c-level-agents plugin.json: v1.1.0 -> v1.2.0 (10 agents, 18 commands)
- marketplace.json: both c-level entries; new CDO keywords (chief-data-officer,
  cdo, ai-training-data, data-product-strategy, data-as-asset)
- c-level CLAUDE.md: CDO row added; agent + count tables updated
- Root CLAUDE.md: 264 -> 265 skills, 29 -> 30 cs-* agents, 361 -> 364 tools,
  490 -> 494 references, 50 -> 51 commands; v2.5.2 highlight added
- CHANGELOG.md: v2.5.2 entry with karpathy-discipline rationale

Disclaimer in every output: not legal advice; not a replacement for outside
counsel on productization/licensing; not a tactical data engineering skill.

https://claude.ai/code/session_012WtZMm5NJHqkYoRqA9fHMN
2026-05-12 15:20:52 +00:00
alirezarezvani
7d677bc046 chore: sync codex skills symlinks [automated] 2026-05-12 14:31:42 +00:00
Alireza Rezvani
28cee6d4f2
Merge pull request #619 from alirezarezvani/feature/general-counsel-advisor
feat(general-counsel-advisor): full skill backing /cs:gc-review (v2.5.1)
2026-05-12 16:31:19 +02:00
Claude
8bbde435b9
feat(general-counsel-advisor): full skill backing /cs:gc-review
Closes the gstack-can't-touch lane: gstack has zero legal coverage; this is
the first plugin in the founder-mode lineup to outclass it on a domain it
doesn't even attempt. Legal exposure is where startups most often discover a
problem after it's expensive to fix.

New skill (c-level-advisor/skills/general-counsel-advisor/):
- SKILL.md with 4 workflows (contract review, term sheet response, IP hygiene
  audit, regulatory trigger assessment), keywords, output standards
- scripts/contract_risk_scanner.py — scans contract text for 12 founder-killer
  patterns (auto-renew traps, uncapped indemnity, vague IP, aggressive
  non-compete, missing DPA when personal data flows, MFN pricing, perpetual
  license-back, one-sided force majeure/venue/audit, broad non-solicit).
  Stdlib-only, JSON+text output, --help. Smoke-tested: 7 findings on embedded
  sample MSA across CRITICAL/HIGH/MEDIUM.
- scripts/term_sheet_analyzer.py — scores term sheet 0-100 across 12 dimensions
  (liquidation preference, anti-dilution, option pool pre/post-money, board,
  vesting, pro-rata, drag-along, protective provisions, info rights, dividends,
  valuation, holistic). Stdlib-only, JSON-input + JSON+text output, --help.
  Smoke-tested: founder-friendly Series A sample scores 94/100.
- references/contracts_playbook.md — 7 startup contract types with top redlines
- references/ip_and_regulatory.md — IP strategy + regulatory trigger matrix
  (HIPAA/GDPR/FDA/fintech/AI Act) + SOC 2 -> ISO sequencing
- references/term_sheet_decoder.md — full glossary, founder-friendly defaults,
  the 3 clauses that matter most, negotiation strategy

New agent (c-level-advisor/c-level-agents/agents/cs-general-counsel-advisor.md):
- Risk-paranoid persona orchestrating the skill
- Voice: "Before we sign, three things need to be settled in writing."
- Hard rule: never substitutes for licensed counsel; always escalates

Updates:
- /cs:gc-review SKILL.md: now points at the real skill + tools (was a planned-
  skill placeholder before)
- c-level-advisor/.claude-plugin/plugin.json: v2.5.0 -> v2.5.1, description
  updated to 29 skills (was 28)
- c-level-advisor/c-level-agents/.claude-plugin/plugin.json: v1.0.0 -> v1.1.0,
  9 cs-* agents (was 8)
- marketplace.json: both c-level entries bumped, +contract-review, +term-sheet,
  +ip-strategy keywords
- c-level-advisor/CLAUDE.md: General Counsel added to roles table; agents and
  counts updated
- Root CLAUDE.md: 263 -> 264 skills, 28 -> 29 cs-* agents, 359 -> 361 Python
  tools, 487 -> 490 references; v2.5.1 highlight section added
- CHANGELOG.md: full v2.5.1 entry with rationale

Disclaimer: every tool/reference/agent output reminds users this is not legal
advice; always engage qualified counsel. The skill is positioned as triage
before $500/hour counsel time, never as a substitute.

https://claude.ai/code/session_012WtZMm5NJHqkYoRqA9fHMN
2026-05-12 14:24:28 +00:00
Alireza Rezvani
af15fac2bb
Merge pull request #618 from alirezarezvani/claude/c-level-agents-plugin-ygLvG
feat(c-level-agents): founder-mode plugin — 8 cs-* agents + 17 /cs:* commands
2026-05-12 16:14:07 +02:00
Claude
921272ef7a
feat(c-level-agents): founder-mode plugin with 8 cs-* agents and 17 /cs:* commands
New plugin at c-level-advisor/c-level-agents/ that surfaces the 28 existing
c-level skills through persona agents and slash commands. Business-domain
answer to YC Garry Tan's gstack: broader role coverage (real CFO/CMO/CRO/GC/
CISO, not just code-shipping personas), forcing-question office hours, 6-phase
boardroom with Phase 2 isolation, strategic sprint pipeline, multi-model
cross-eval, and decision freeze.

Agents (8 cs-* personas with moderate voice differentiation):
- cs-cfo-advisor (numerate skeptic)
- cs-cmo-advisor (narrative-first)
- cs-cro-advisor (pipeline-paranoid)
- cs-cpo-advisor (JTBD-driven)
- cs-coo-advisor (execution OS)
- cs-chro-advisor (people-systems)
- cs-ciso-advisor (risk-paranoid)
- cs-chief-of-staff (router + synthesist)

Slash commands (17 /cs:* sub-skills):
- Forcing questions (8): /cs:office-hours, /cs:cfo-review, /cs:cmo-review,
  /cs:cpo-review, /cs:cro-review, /cs:cto-review, /cs:ciso-review, /cs:gc-review
- Strategic sprint pipeline (5): /cs:brief -> /cs:boardroom -> /cs:decide ->
  /cs:execute -> /cs:post-mortem
- Meta + safety (4): /cs:founder-mode (auto-router), /cs:onboard, /cs:cross-eval
  (multi-model with Claude-only graceful degradation), /cs:freeze

References:
- persona-voices.md (per-role voice specs)
- llm-wiki-bridge.md (Markdown-only persistent memory, no Postgres dependency)

Integration:
- Marketplace.json: new c-level-agents entry, c-level-skills bumped to v2.5.0
- c-level-advisor/.claude-plugin/plugin.json: bumped to v2.5.0 with expanded description
- c-level-advisor/CLAUDE.md: documents new plugin layer
- Root CLAUDE.md: counts updated (246->263 skills, 27->35 agents, 33->50 commands)
- CHANGELOG.md: 2.5.0 entry

https://claude.ai/code/session_012WtZMm5NJHqkYoRqA9fHMN
2026-05-12 13:52:54 +00:00
YakovBeder
0898558e1f fix(integrations): update find depth in convert.sh for new repo structure
The skill directory layout changed from depth-3 (category/skill/SKILL.md)
to depth-4+ (team/skills/skill-name/SKILL.md). The find command in
convert.sh still used -mindepth 3 -maxdepth 3, causing "No skills found"
errors. Updated to -mindepth 4 -maxdepth 6 and excluded integrations/ to
avoid picking up already-converted output.

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-05-12 09:56:39 +03:00
Alireza Rezvani
c96d6dca08
Merge pull request #616 from alirezarezvani/main
Some checks are pending
Sync Codex Skills Symlinks / sync (push) Waiting to run
2026-05-11 20:07:41 +02:00
Alireza Rezvani
8d3c5784f2
Merge pull request #614 from alirezarezvani/dev
Some checks failed
Deploy Documentation to Pages / build (push) Has been cancelled
Sync Codex Skills Symlinks / sync (push) Has been cancelled
Deploy Documentation to Pages / deploy (push) Has been cancelled
2026-05-11 16:22:37 +02:00
Alireza Rezvani
8a45377bc6
Merge pull request #613 from alirezarezvani/claude/address-open-issues-Zpeqd
fix: address 5 open issues — marketing dead links, PR template collision, si-agent name guard, hunt-playbook AV banner
2026-05-11 15:38:35 +02:00
Claude
5c6410e2a7
docs(threat-detection): add AV false-positive banner to hunt-playbooks
Bitdefender (and similar heuristic AV/EDR products) quarantine the
hunt-playbooks reference because it lists the command-line patterns
associated with LOLBin abuse (certutil -decode, regsvr32 /s /u /i:http
scrobj.dll, mshta URL, etc.). The strings appear inside markdown
tables and cannot execute from a .md file — this is defensive
threat-hunting documentation.

Added a banner at the top that:
- States the defensive-doc intent explicitly
- Lists the binaries cited and why they appear
- Tells affected users how to allow-list the path
- Links to the tracking issue

Closes #533
2026-05-11 13:14:46 +00:00
Claude
b69842562a
fix(self-improving-agent): forbid reserved 'claude'/'anthropic' fragments in generated names
The /si:extract command and its skill-extractor agent had no guard
against the Claude Code skill-spec reserved name fragments. Users
reported the agent autogenerating skills like 'claude-code-settings',
'claude-mcp-tools', etc. — all of which violate the spec.

- Add explicit reserved-fragment rule to both the slash-command
  SKILL.md and the agent definition.
- Recommend the 'cc-' prefix for Claude Code-specific skills
  (cc-settings, cc-maintenance, cc-mcp-tools).
- Add the check to both quality-gate checklists so the agent
  surfaces a rename before writing files.

Closes #537
2026-05-11 13:14:39 +00:00
Claude
1f910cdcac
fix(marketing): remove dead reference links across CRO + SEO skills
Five SKILL.md files linked to references/*.md files that don't exist
on disk:

- onboarding-cro, paywall-upgrade-cro, page-cro → references/experiments.md
- programmatic-seo → references/playbooks.md
- seo-audit → references/ai-writing-detection.md, references/aeo-geo-patterns.md

The 4 CRO/pSEO links pointed to placeholder content that was never
authored — removed the link lines (the surrounding sections still
hold the substantive guidance). The seo-audit References section is
re-anchored to the 4 reference files that actually exist
(seo-audit-reference, cwv-thresholds, eeat-framework, schema-types).

Closes #586
2026-05-11 13:14:31 +00:00
Claude
93ea5e21ee
docs(.github): remove case-colliding lowercase PR template
The lowercase pull_request_template.md was an exact duplicate of
PULL_REQUEST_TEMPLATE.md. On case-insensitive filesystems (Windows,
default macOS), git clone emits a path-collision warning and only
one file lands in the working tree.

Closes #545
2026-05-11 13:14:24 +00:00
Alireza Rezvani
563b5efa78
Merge pull request #611 from alirezarezvani/dev
Release v2.4.5 — Reliability Portfolio + Count-Truth Reconciliation
2026-05-11 14:29:07 +02:00
Alireza Rezvani
0a0ab405d7
Merge pull request #610 from alirezarezvani/claude/release-v2.4.5
chore(release): v2.4.5 — close out unreleased work + count reconciliation
2026-05-11 10:11:43 +02:00
Claude
a417df7144
chore(release): v2.4.5 — close out unreleased work + count reconciliation
Promotes the 11 commits accumulated on dev since v2.4.4 into a tagged
release before opening the dev->main PR.

Version bumps (root-level only — per-skill version stamps unchanged):
  .claude-plugin/marketplace.json metadata.version: 2.4.4 -> 2.4.5
  CLAUDE.md 'Version:' headers (x2): v2.4.4 -> v2.4.5
  CLAUDE.md 'Last Updated': May 10 -> May 11, 2026

Deliberately NOT bumped:
  - slo-architect plugin version (marketplace.json line 643) stays 2.4.4
    -- that's the skill's own release stamp, not the repo version
  - SKILL.md frontmatter versions in engineering/skills/slo-architect/
    and engineering/slo-architect/skills/slo-architect/ -- same reason

CHANGELOG.md changes:
  - [Unreleased] block renamed to [2.4.5] - 2026-05-11
  - Title broadened to include 'Count-Truth Reconciliation' alongside the
    original 'Skill Expansion Phase 1+2+3+4 (+ ship-gate)'
  - 'Changed' totals corrected to file-system truth:
      Skills:    235 -> 246 (was claimed 235 -> 238)
      Tools:     314 -> 359 (was claimed 314 -> 325)
      References:435 -> 485 (was claimed 435 -> 447)
      Agents:    added (28 -> 27, was missing)
      Commands:  27  -> 33  (was claimed 27 -> 30)
      Plugins:   added (30 -> 33, was missing)
  - 'Fixed' subsection: added bullets for #608 (count corrections) and
    #609 (marketplace registry + integrations.md), plus
    skill-security-auditor self-skip fix

Why the v2.4.4 unreleased totals were wrong: the entry was drafted
mid-cycle and never reconciled before tagging. #608/#609 caught the
drift. The v2.4.5 totals now reproduce from one find/python3 command
each (commands documented inline in the changelog bullets).
2026-05-11 06:39:29 +00:00
Alireza Rezvani
dd0c3bdf9e
Merge pull request #609 from alirezarezvani/claude/correct-counts-pass-2 2026-05-11 08:27:27 +02:00