scriptoriumadmin/claude-skills
1
0
Fork 0
mirror of https://github.com/alirezarezvani/claude-skills.git synced 2026-10-09 03:17:54 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions
924 commits 6 branches 7 tags 44 MiB
Commit graph

26 commits

Author SHA1 Message Date
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