scriptoriumadmin/claude-skills
1
0
Fork 0
mirror of https://github.com/alirezarezvani/claude-skills.git synced 2026-08-28 04:24:58 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 4

fix: phantom-path sweep — 888 unresolvable references to zero

Browse source 
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
This commit is contained in:
Claude 2026-06-10 14:33:00 +00:00
parent b99505446a
commit a088c8ba77
No known key found for this signature in database
149 changed files with 1128 additions and 899 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

1
agents/c-level/cs-cto-advisor.md
View file

@ -396,7 +396,6 @@ echo "- Process improvements identified"
- [cs-ceo-advisor](cs-ceo-advisor.md) - Strategic leadership and organizational development (CEO counterpart)
- [cs-fullstack-engineer](../engineering/cs-fullstack-engineer.md) - Fullstack development coordination (planned)
- [cs-devops-specialist](../engineering/cs-devops-specialist.md) - DevOps and infrastructure automation (planned)
## References

54
agents/engineering-team/cs-workspace-admin.md
View file

@ -21,44 +21,44 @@ Google Workspace administration specialist orchestrating the gws CLI for email a
### Python Tools
1. **GWS Doctor**
- **Path:** `../../engineering-team/google-workspace-cli/scripts/gws_doctor.py`
- **Usage:** `python3 ../../engineering-team/google-workspace-cli/scripts/gws_doctor.py [--json]`
- **Path:** `../../engineering-team/google-workspace-cli/skills/google-workspace-cli/scripts/gws_doctor.py`
- **Usage:** `python3 ../../engineering-team/google-workspace-cli/skills/google-workspace-cli/scripts/gws_doctor.py [--json]`
- **Purpose:** Pre-flight diagnostics — checks installation, auth, and service connectivity
2. **Auth Setup Guide**
- **Path:** `../../engineering-team/google-workspace-cli/scripts/auth_setup_guide.py`
- **Usage:** `python3 ../../engineering-team/google-workspace-cli/scripts/auth_setup_guide.py --guide oauth`
- **Path:** `../../engineering-team/google-workspace-cli/skills/google-workspace-cli/scripts/auth_setup_guide.py`
- **Usage:** `python3 ../../engineering-team/google-workspace-cli/skills/google-workspace-cli/scripts/auth_setup_guide.py --guide oauth`
- **Purpose:** Guided auth setup, scope listing, .env generation, validation
3. **Recipe Runner**
- **Path:** `../../engineering-team/google-workspace-cli/scripts/gws_recipe_runner.py`
- **Usage:** `python3 ../../engineering-team/google-workspace-cli/scripts/gws_recipe_runner.py --list`
- **Path:** `../../engineering-team/google-workspace-cli/skills/google-workspace-cli/scripts/gws_recipe_runner.py`
- **Usage:** `python3 ../../engineering-team/google-workspace-cli/skills/google-workspace-cli/scripts/gws_recipe_runner.py --list`
- **Purpose:** Catalog, search, and execute 43 built-in recipes with persona filtering
4. **Workspace Audit**
- **Path:** `../../engineering-team/google-workspace-cli/scripts/workspace_audit.py`
- **Usage:** `python3 ../../engineering-team/google-workspace-cli/scripts/workspace_audit.py [--json]`
- **Path:** `../../engineering-team/google-workspace-cli/skills/google-workspace-cli/scripts/workspace_audit.py`
- **Usage:** `python3 ../../engineering-team/google-workspace-cli/skills/google-workspace-cli/scripts/workspace_audit.py [--json]`
- **Purpose:** Security and configuration audit across Workspace services
5. **Output Analyzer**
- **Path:** `../../engineering-team/google-workspace-cli/scripts/output_analyzer.py`
- **Usage:** `gws ... --json | python3 ../../engineering-team/google-workspace-cli/scripts/output_analyzer.py --count`
- **Path:** `../../engineering-team/google-workspace-cli/skills/google-workspace-cli/scripts/output_analyzer.py`
- **Usage:** `gws ... --json | python3 ../../engineering-team/google-workspace-cli/skills/google-workspace-cli/scripts/output_analyzer.py --count`
- **Purpose:** Parse, filter, and aggregate JSON/NDJSON output from any gws command
### Knowledge Bases
1. **Command Reference** — `../../engineering-team/google-workspace-cli/references/gws-command-reference.md`
1. **Command Reference** — `../../engineering-team/google-workspace-cli/skills/google-workspace-cli/references/gws-command-reference.md`
- 18 services, 22 helpers, global flags, environment variables
2. **Recipes Cookbook** — `../../engineering-team/google-workspace-cli/references/recipes-cookbook.md`
2. **Recipes Cookbook** — `../../engineering-team/google-workspace-cli/skills/google-workspace-cli/references/recipes-cookbook.md`
- 43 recipes organized by category with persona mapping
3. **Troubleshooting** — `../../engineering-team/google-workspace-cli/references/troubleshooting.md`
3. **Troubleshooting** — `../../engineering-team/google-workspace-cli/skills/google-workspace-cli/references/troubleshooting.md`
- Common errors, auth issues, platform-specific fixes
### Templates
1. **Workspace Config** — `../../engineering-team/google-workspace-cli/assets/workspace-config.json`
1. **Workspace Config** — `../../engineering-team/google-workspace-cli/skills/google-workspace-cli/assets/workspace-config.json`
- Automation config template with auth, defaults, scheduled tasks
2. **Persona Profiles** — `../../engineering-team/google-workspace-cli/assets/persona-profiles.md`
2. **Persona Profiles** — `../../engineering-team/google-workspace-cli/skills/google-workspace-cli/assets/persona-profiles.md`
- 10 role-based workflow bundles
## Core Workflows
@ -77,9 +77,9 @@ Google Workspace administration specialist orchestrating the gws CLI for email a
**Example:**
```bash
python3 ../../engineering-team/google-workspace-cli/scripts/gws_doctor.py
python3 ../../engineering-team/google-workspace-cli/scripts/auth_setup_guide.py --guide oauth
python3 ../../engineering-team/google-workspace-cli/scripts/auth_setup_guide.py --validate --json
python3 ../../engineering-team/google-workspace-cli/skills/google-workspace-cli/scripts/gws_doctor.py
python3 ../../engineering-team/google-workspace-cli/skills/google-workspace-cli/scripts/auth_setup_guide.py --guide oauth
python3 ../../engineering-team/google-workspace-cli/skills/google-workspace-cli/scripts/auth_setup_guide.py --validate --json
```
### 2. Daily Operations
@ -94,9 +94,9 @@ python3 ../../engineering-team/google-workspace-cli/scripts/auth_setup_guide.py
**Example:**
```bash
python3 ../../engineering-team/google-workspace-cli/scripts/gws_recipe_runner.py --persona pm --list
python3 ../../engineering-team/google-workspace-cli/scripts/gws_recipe_runner.py --run standup-report --dry-run
gws recipes standup-report --json | python3 ../../engineering-team/google-workspace-cli/scripts/output_analyzer.py --format table
python3 ../../engineering-team/google-workspace-cli/skills/google-workspace-cli/scripts/gws_recipe_runner.py --persona pm --list
python3 ../../engineering-team/google-workspace-cli/skills/google-workspace-cli/scripts/gws_recipe_runner.py --run standup-report --dry-run
gws recipes standup-report --json | python3 ../../engineering-team/google-workspace-cli/skills/google-workspace-cli/scripts/output_analyzer.py --format table
```
### 3. Security Audit
@ -112,9 +112,9 @@ gws recipes standup-report --json | python3 ../../engineering-team/google-worksp
**Example:**
```bash
python3 ../../engineering-team/google-workspace-cli/scripts/workspace_audit.py --json
python3 ../../engineering-team/google-workspace-cli/scripts/workspace_audit.py --json | \
python3 ../../engineering-team/google-workspace-cli/scripts/output_analyzer.py --filter "status=FAIL"
python3 ../../engineering-team/google-workspace-cli/skills/google-workspace-cli/scripts/workspace_audit.py --json
python3 ../../engineering-team/google-workspace-cli/skills/google-workspace-cli/scripts/workspace_audit.py --json | \
python3 ../../engineering-team/google-workspace-cli/skills/google-workspace-cli/scripts/output_analyzer.py --filter "status=FAIL"
```
### 4. Automation Scripting
@ -130,9 +130,9 @@ python3 ../../engineering-team/google-workspace-cli/scripts/workspace_audit.py -
**Example:**
```bash
python3 ../../engineering-team/google-workspace-cli/scripts/gws_recipe_runner.py --describe morning-briefing
python3 ../../engineering-team/google-workspace-cli/skills/google-workspace-cli/scripts/gws_recipe_runner.py --describe morning-briefing
# Customize and test
gws helpers morning-briefing --json | python3 ../../engineering-team/google-workspace-cli/scripts/output_analyzer.py --select "type,summary,time" --format table
gws helpers morning-briefing --json | python3 ../../engineering-team/google-workspace-cli/skills/google-workspace-cli/scripts/output_analyzer.py --select "type,summary,time" --format table
```
## Output Standards
@ -156,5 +156,5 @@ gws helpers morning-briefing --json | python3 ../../engineering-team/google-work
## References
- [Skill Documentation](../../engineering-team/google-workspace-cli/SKILL.md)
- [Skill Documentation](../../engineering-team/google-workspace-cli/skills/google-workspace-cli/SKILL.md)
- [gws CLI Repository](https://github.com/googleworkspace/cli)

4
agents/engineering/cs-backend-engineer.md
View file

@ -123,8 +123,8 @@ python ../../engineering/karpathy-coder/skills/karpathy-coder/scripts/diff_surge
- [cs-frontend-engineer](cs-frontend-engineer.md) — fork into for API consumers
- [cs-karpathy-reviewer](cs-karpathy-reviewer.md) — invoke before every commit
- [cs-cto-advisor](../c-level/cs-cto-advisor.md) — escalate strategic build-vs-buy
- [cs-vpe-advisor](../c-level/cs-vpe-advisor.md) — escalate throughput / org / DORA
- [cs-ciso-advisor](../c-level/cs-ciso-advisor.md) — escalate regulated-data exposure
- [cs-vpe-advisor](../../c-level-advisor/c-level-agents/agents/cs-vpe-advisor.md) — escalate throughput / org / DORA
- [cs-ciso-advisor](../../c-level-advisor/c-level-agents/agents/cs-ciso-advisor.md) — escalate regulated-data exposure
## Invocation Contract

2
agents/engineering/cs-fullstack-engineer.md
View file

@ -163,7 +163,7 @@ python ../../engineering/karpathy-coder/skills/karpathy-coder/scripts/diff_surge
- [cs-karpathy-reviewer](cs-karpathy-reviewer.md) — invoke before every commit
- [cs-senior-engineer](cs-senior-engineer.md) — cross-cutting engineering lead (use for non-stack questions like CI/CD, security review)
- [cs-cto-advisor](../c-level/cs-cto-advisor.md) — escalate for strategic build-vs-buy or technical debt prioritization
- [cs-vpe-advisor](../c-level/cs-vpe-advisor.md) — escalate for org-design + throughput
- [cs-vpe-advisor](../../c-level-advisor/c-level-agents/agents/cs-vpe-advisor.md) — escalate for org-design + throughput
## Invocation Contract

2
agents/engineering/cs-wiki-ingestor.md
View file

@ -24,7 +24,7 @@ You are spawned **per-ingest**, not as a long-running agent. You do one source a
## Workflow
Follow `references/ingest-workflow.md` in the llm-wiki skill. Summary:
Follow `engineering/llm-wiki/skills/llm-wiki/references/ingest-workflow.md` in the llm-wiki skill. Summary:
### 1. Prep
Run `python <plugin>/scripts/ingest_source.py --vault . --source <path> --json` to get the brief (title guess, word count, preview, suggested summary path, whether a summary already exists).

4
agents/engineering/cs-wiki-librarian.md
View file

@ -23,7 +23,7 @@ You are spawned **per-query**, not as a long-running agent.
## Workflow
Follow `references/query-workflow.md`. Summary:
Follow `engineering/llm-wiki/skills/llm-wiki/references/query-workflow.md`. Summary:
### 1. Read `index.md` first
The index is the catalog. Scan it and pick the 3-10 pages most likely to contain the answer. Pick across categories:
@ -62,7 +62,7 @@ This is the compounding move. At the end of the answer, ask:
If yes:
- Pick the right category (most often `comparisons/` or `synthesis/`)
- Use the appropriate template (see llm-wiki skill's `references/page-formats.md`)
- Use the appropriate template (see llm-wiki skill's `engineering/llm-wiki/skills/llm-wiki/references/page-formats.md`)
- Add frontmatter with `category`, `summary`, `sources` (count), `updated`
- Update `wiki/index.md` (inline or via script)
- Append to `log.md`: `python <plugin>/scripts/append_log.py --vault . --op create --title "<question>" --detail "filed query response to <path>"`

2
agents/engineering/cs-wiki-linter.md
View file

@ -18,7 +18,7 @@ You are spawned **per-lint-pass**, not as a long-running agent.
## Workflow
Follow `references/lint-workflow.md`. Three passes.
Follow `engineering/llm-wiki/skills/llm-wiki/references/lint-workflow.md`. Three passes.
### Pass 1 — Mechanical (scripts)

10
agents/finance/cs-financial-analyst.md
View file

@ -85,23 +85,23 @@ Financial analyst covering valuation, ratio analysis, forecasting, and industry-
```bash
# SaaS health check — full metrics from raw numbers
python ../../finance/saas-metrics-coach/scripts/metrics_calculator.py \
python ../../finance/skills/saas-metrics-coach/scripts/metrics_calculator.py \
--mrr 80000 --mrr-last 75000 --customers 200 --churned 3 \
--new-customers 15 --sm-spend 25000 --gross-margin 72 --json
# Quick ratio — growth efficiency
python ../../finance/saas-metrics-coach/scripts/quick_ratio_calculator.py \
python ../../finance/skills/saas-metrics-coach/scripts/quick_ratio_calculator.py \
--new-mrr 10000 --expansion 2000 --churned 3000 --contraction 500
# 12-month projection
python ../../finance/saas-metrics-coach/scripts/unit_economics_simulator.py \
python ../../finance/skills/saas-metrics-coach/scripts/unit_economics_simulator.py \
--mrr 80000 --growth 8 --churn 1.5 --cac 1667 --json
# Traditional ratio analysis
python ../../finance/financial-analyst/scripts/ratio_calculator.py financial_data.json --format json
python ../../finance/skills/financial-analyst/scripts/ratio_calculator.py financial_data.json --format json
# DCF valuation
python ../../finance/financial-analyst/scripts/dcf_valuation.py valuation_data.json --format json
python ../../finance/skills/financial-analyst/scripts/dcf_valuation.py valuation_data.json --format json
```
## Related Agents

10
agents/marketing/cs-aeo.md
View file

@ -72,14 +72,14 @@ Differentiates from siblings:
### Reference docs (each cites 7+ sources)
- `references/aeo_eeat_canon.md` — E-E-A-T methodology for AI citation (8 sources)
- `references/llm_citation_patterns.md` — How each major LLM chooses sources (8 sources)
- `references/aeo_vs_seo.md` — The two disciplines, overlap, and strategic choice (8 sources)
- `marketing-skill/skills/aeo/references/aeo_eeat_canon.md` — E-E-A-T methodology for AI citation (8 sources)
- `marketing-skill/skills/aeo/references/llm_citation_patterns.md` — How each major LLM chooses sources (8 sources)
- `marketing-skill/skills/aeo/references/aeo_vs_seo.md` — The two disciplines, overlap, and strategic choice (8 sources)
## Related Agents
- [cs-content-creator](../../agents/cs-content-creator.md) — marketing-domain content writer
- [cs-seo-audit](../../agents/cs-seo-audit.md) — companion SEO audit (often run together)
- [cs-content-creator](cs-content-creator.md) — marketing-domain content writer
- [seo-audit skill](../../marketing-skill/skills/seo-audit/SKILL.md) — companion SEO audit (often run together)
- DIFFERENT use case: `engineering/autoresearch-agent` (Karpathy's file-optimization loop — orthogonal)
---

54
agents/marketing/cs-content-creator.md
View file

@ -19,7 +19,7 @@ The cs-content-creator agent bridges the gap between creative content production
## Skill Integration
**Skill Location:** `../../marketing-skill/content-creator/`
**Skill Location:** `../../marketing-skill/skills/content-creator/`
### Python Tools
@ -28,29 +28,29 @@ No Python tools — this skill relies on SKILL.md workflows, knowledge bases, an
### Knowledge Bases
1. **Brand Guidelines**
- **Location:** `../../marketing-skill/content-creator/references/brand_guidelines.md`
- **Location:** `../../marketing-skill/skills/content-creator/references/brand_guidelines.md`
- **Content:** 5 personality archetypes (Expert, Friend, Innovator, Guide, Motivator), voice characteristics matrix, consistency checklist
- **Use Case:** Establishing brand voice, onboarding writers, content audits
2. **Content Frameworks**
- **Location:** `../../marketing-skill/content-creator/references/content_frameworks.md`
- **Location:** `../../marketing-skill/skills/content-creator/references/content_frameworks.md`
- **Content:** 15+ content templates including blog posts (how-to, listicle, case study), email campaigns, social media posts, video scripts, landing page copy
- **Use Case:** Content planning, writer guidance, structure templates
3. **Social Media Optimization**
- **Location:** `../../marketing-skill/content-creator/references/social_media_optimization.md`
- **Location:** `../../marketing-skill/skills/content-creator/references/social_media_optimization.md`
- **Content:** Platform-specific best practices for LinkedIn (1,300 chars, professional tone), Twitter/X (280 chars, concise), Instagram (visual-first, caption strategy), Facebook (engagement tactics), TikTok (short-form video)
- **Use Case:** Platform optimization, social media strategy, content adaptation
4. **Analytics Guide**
- **Location:** `../../marketing-skill/content-creator/references/analytics_guide.md`
- **Location:** `../../marketing-skill/skills/content-creator/references/analytics_guide.md`
- **Content:** Content performance analytics and measurement frameworks
- **Use Case:** Content performance tracking, reporting, data-driven optimization
### Templates
1. **Content Calendar Template**
- **Location:** `../../marketing-skill/content-creator/assets/content_calendar_template.md`
- **Location:** `../../marketing-skill/skills/content-creator/assets/content_calendar_template.md`
- **Use Case:** Planning monthly content, tracking production pipeline
## Workflows
@ -63,11 +63,11 @@ No Python tools — this skill relies on SKILL.md workflows, knowledge bases, an
1. **Draft Content** - Write initial blog post draft in markdown format
2. **Reference Brand Guidelines** - Review brand voice requirements for tone and readability
```bash
cat ../../marketing-skill/content-creator/references/brand_guidelines.md
cat ../../marketing-skill/skills/content-creator/references/brand_guidelines.md
```
3. **Review Content Frameworks** - Select appropriate blog post template (how-to, listicle, case study)
```bash
cat ../../marketing-skill/content-creator/references/content_frameworks.md
cat ../../marketing-skill/skills/content-creator/references/content_frameworks.md
```
4. **Optimize for SEO** - Apply SEO best practices from SKILL.md workflows (keyword placement, structure, meta description)
5. **Implement Recommendations** - Update content structure, keyword placement, meta description
@ -80,8 +80,8 @@ No Python tools — this skill relies on SKILL.md workflows, knowledge bases, an
**Example:**
```bash
# Review guidelines before writing
cat ../../marketing-skill/content-creator/references/brand_guidelines.md
cat ../../marketing-skill/content-creator/references/content_frameworks.md
cat ../../marketing-skill/skills/content-creator/references/brand_guidelines.md
cat ../../marketing-skill/skills/content-creator/references/content_frameworks.md
```
### Workflow 2: Multi-Platform Content Adaptation
@ -92,14 +92,14 @@ cat ../../marketing-skill/content-creator/references/content_frameworks.md
1. **Start with Core Content** - Begin with blog post or long-form content
2. **Reference Platform Guidelines** - Review platform-specific best practices
```bash
cat ../../marketing-skill/content-creator/references/social_media_optimization.md
cat ../../marketing-skill/skills/content-creator/references/social_media_optimization.md
```
3. **Create LinkedIn Version** - Professional tone, 1,300 characters, 3-5 hashtags
4. **Create Twitter/X Thread** - Break into 280-char tweets, engaging hook
5. **Create Instagram Caption** - Visual-first approach, caption with line breaks, hashtags
6. **Validate Brand Voice** - Ensure consistency across all versions by reviewing against brand guidelines
```bash
cat ../../marketing-skill/content-creator/references/brand_guidelines.md
cat ../../marketing-skill/skills/content-creator/references/brand_guidelines.md
```
**Expected Output:** 4-5 platform-optimized versions from single source
@ -114,12 +114,12 @@ cat ../../marketing-skill/content-creator/references/content_frameworks.md
1. **Collect Content** - Gather markdown files for all published content
2. **Brand Voice Review** - Review each content piece against brand guidelines for consistency
```bash
cat ../../marketing-skill/content-creator/references/brand_guidelines.md
cat ../../marketing-skill/skills/content-creator/references/brand_guidelines.md
```
3. **Identify Inconsistencies** - Check formality, tone patterns, and readability against brand archetypes
4. **SEO Audit** - Review content structure against content frameworks best practices
```bash
cat ../../marketing-skill/content-creator/references/content_frameworks.md
cat ../../marketing-skill/skills/content-creator/references/content_frameworks.md
```
5. **Create Improvement Plan** - Prioritize content updates based on SEO score and brand alignment
6. **Implement Updates** - Revise content following brand guidelines and SEO recommendations
@ -131,8 +131,8 @@ cat ../../marketing-skill/content-creator/references/content_frameworks.md
**Example:**
```bash
# Review brand guidelines and frameworks before auditing content
cat ../../marketing-skill/content-creator/references/brand_guidelines.md
cat ../../marketing-skill/content-creator/references/analytics_guide.md
cat ../../marketing-skill/skills/content-creator/references/brand_guidelines.md
cat ../../marketing-skill/skills/content-creator/references/analytics_guide.md
```
### Workflow 4: Campaign Content Planning
@ -142,22 +142,22 @@ cat ../../marketing-skill/content-creator/references/analytics_guide.md
**Steps:**
1. **Reference Content Frameworks** - Select appropriate templates for campaign
```bash
cat ../../marketing-skill/content-creator/references/content_frameworks.md
cat ../../marketing-skill/skills/content-creator/references/content_frameworks.md
```
2. **Copy Content Calendar** - Use template for campaign planning
```bash
cp ../../marketing-skill/content-creator/assets/content_calendar_template.md campaign-calendar.md
cp ../../marketing-skill/skills/content-creator/assets/content_calendar_template.md campaign-calendar.md
```
3. **Define Brand Voice Target** - Reference brand guidelines for campaign tone
```bash
cat ../../marketing-skill/content-creator/references/brand_guidelines.md
cat ../../marketing-skill/skills/content-creator/references/brand_guidelines.md
```
4. **Create Content Briefs** - Use brief template for each content piece
5. **Draft All Content** - Produce blog posts, social media posts, email campaigns
6. **Validate Before Publishing** - Review all campaign content against brand guidelines and social media optimization guides
```bash
cat ../../marketing-skill/content-creator/references/brand_guidelines.md
cat ../../marketing-skill/content-creator/references/social_media_optimization.md
cat ../../marketing-skill/skills/content-creator/references/brand_guidelines.md
cat ../../marketing-skill/skills/content-creator/references/social_media_optimization.md
```
**Expected Output:** Complete campaign content library with consistent brand voice and optimized SEO
@ -175,11 +175,11 @@ cat ../../marketing-skill/content-creator/references/analytics_guide.md
CONTENT_FILE=$1
echo "Reviewing brand voice guidelines..."
cat ../../marketing-skill/content-creator/references/brand_guidelines.md
cat ../../marketing-skill/skills/content-creator/references/brand_guidelines.md
echo ""
echo "Reviewing content frameworks..."
cat ../../marketing-skill/content-creator/references/content_frameworks.md
cat ../../marketing-skill/skills/content-creator/references/content_frameworks.md
echo ""
echo "Review complete. Compare $CONTENT_FILE against the guidelines above."
@ -191,7 +191,7 @@ echo "Review complete. Compare $CONTENT_FILE against the guidelines above."
```bash
# Review platform guidelines before adapting content
cat ../../marketing-skill/content-creator/references/social_media_optimization.md
cat ../../marketing-skill/skills/content-creator/references/social_media_optimization.md
# Key platform limits to follow:
# - LinkedIn: 1,300 chars, professional tone, 3-5 hashtags
@ -203,10 +203,10 @@ cat ../../marketing-skill/content-creator/references/social_media_optimization.m
```bash
# Set up content calendar from template
cp ../../marketing-skill/content-creator/assets/content_calendar_template.md campaign-calendar.md
cp ../../marketing-skill/skills/content-creator/assets/content_calendar_template.md campaign-calendar.md
# Review analytics guide for performance tracking
cat ../../marketing-skill/content-creator/references/analytics_guide.md
cat ../../marketing-skill/skills/content-creator/references/analytics_guide.md
```
## Success Metrics
@ -234,7 +234,7 @@ cat ../../marketing-skill/content-creator/references/analytics_guide.md
## References
- **Skill Documentation:** [../../marketing-skill/content-creator/SKILL.md](../../marketing-skill/content-creator/SKILL.md)
- **Skill Documentation:** [../../marketing-skill/skills/content-creator/SKILL.md](../../marketing-skill/skills/content-creator/SKILL.md)
- **Marketing Domain Guide:** [../../marketing-skill/CLAUDE.md](../../marketing-skill/CLAUDE.md)
- **Agent Development Guide:** [../CLAUDE.md](../CLAUDE.md)
- **Marketing Roadmap:** [../../marketing-skill/marketing_skills_roadmap.md](../../marketing-skill/marketing_skills_roadmap.md)

48
agents/marketing/cs-demand-gen-specialist.md
View file

@ -19,14 +19,14 @@ The cs-demand-gen-specialist agent bridges the gap between marketing strategy an
## Skill Integration
**Skill Location:** `../../marketing-skill/marketing-demand-acquisition/`
**Skill Location:** `../../marketing-skill/skills/marketing-demand-acquisition/`
### Python Tools
1. **CAC Calculator**
- **Purpose:** Calculates Customer Acquisition Cost (CAC) across channels and campaigns
- **Path:** `../../marketing-skill/marketing-demand-acquisition/scripts/calculate_cac.py`
- **Usage:** `python ../../marketing-skill/marketing-demand-acquisition/scripts/calculate_cac.py campaign-spend.csv customer-data.csv`
- **Path:** `../../marketing-skill/skills/marketing-demand-acquisition/scripts/calculate_cac.py`
- **Usage:** `python ../../marketing-skill/skills/marketing-demand-acquisition/scripts/calculate_cac.py campaign-spend.csv customer-data.csv`
- **Features:** CAC calculation by channel, LTV:CAC ratio, payback period analysis, ROI metrics
- **Use Cases:** Budget allocation, channel performance evaluation, campaign ROI analysis
@ -35,22 +35,22 @@ The cs-demand-gen-specialist agent bridges the gap between marketing strategy an
### Knowledge Bases
1. **Attribution Guide**
- **Location:** `../../marketing-skill/marketing-demand-acquisition/references/attribution-guide.md`
- **Location:** `../../marketing-skill/skills/marketing-demand-acquisition/references/attribution-guide.md`
- **Content:** Marketing attribution models, channel attribution, ROI measurement frameworks
- **Use Case:** Campaign attribution, channel performance analysis, budget justification
2. **Campaign Templates**
- **Location:** `../../marketing-skill/marketing-demand-acquisition/references/campaign-templates.md`
- **Location:** `../../marketing-skill/skills/marketing-demand-acquisition/references/campaign-templates.md`
- **Content:** Reusable campaign structures, launch checklists, multi-channel campaign blueprints
- **Use Case:** Campaign planning, rapid campaign setup, standardized launch processes
3. **HubSpot Workflows**
- **Location:** `../../marketing-skill/marketing-demand-acquisition/references/hubspot-workflows.md`
- **Location:** `../../marketing-skill/skills/marketing-demand-acquisition/references/hubspot-workflows.md`
- **Content:** HubSpot automation workflows, lead nurturing sequences, CRM integration patterns
- **Use Case:** Marketing automation, lead scoring, nurture campaign setup
4. **International Playbooks**
- **Location:** `../../marketing-skill/marketing-demand-acquisition/references/international-playbooks.md`
- **Location:** `../../marketing-skill/skills/marketing-demand-acquisition/references/international-playbooks.md`
- **Content:** International market expansion strategies, localization best practices, regional channel optimization
- **Use Case:** Global campaign planning, market entry strategy, cross-border demand generation
@ -68,19 +68,19 @@ No asset templates currently available — use campaign-templates.md reference f
1. **Define Campaign Goals** - Set targets for leads, MQLs, SQLs, conversion rates
2. **Reference Campaign Templates** - Review proven campaign structures and launch checklists
```bash
cat ../../marketing-skill/marketing-demand-acquisition/references/campaign-templates.md
cat ../../marketing-skill/skills/marketing-demand-acquisition/references/campaign-templates.md
```
3. **Select Channels** - Choose optimal mix based on target audience, budget, and attribution models
```bash
cat ../../marketing-skill/marketing-demand-acquisition/references/attribution-guide.md
cat ../../marketing-skill/skills/marketing-demand-acquisition/references/attribution-guide.md
```
4. **Set Up Automation** - Configure HubSpot workflows for lead nurturing
```bash
cat ../../marketing-skill/marketing-demand-acquisition/references/hubspot-workflows.md
cat ../../marketing-skill/skills/marketing-demand-acquisition/references/hubspot-workflows.md
```
5. **Plan International Reach** - Reference international playbooks if targeting multiple markets
```bash
cat ../../marketing-skill/marketing-demand-acquisition/references/international-playbooks.md
cat ../../marketing-skill/skills/marketing-demand-acquisition/references/international-playbooks.md
```
6. **Launch and Monitor** - Deploy campaigns, track metrics, collect data
@ -96,11 +96,11 @@ No asset templates currently available — use campaign-templates.md reference f
1. **Export Campaign Data** - Gather metrics from all acquisition channels (GA4, ad platforms, CRM)
2. **Calculate Channel CAC** - Run CAC calculator to analyze cost efficiency
```bash
python ../../marketing-skill/marketing-demand-acquisition/scripts/calculate_cac.py campaign-spend.csv conversions.csv
python ../../marketing-skill/skills/marketing-demand-acquisition/scripts/calculate_cac.py campaign-spend.csv conversions.csv
```
3. **Map Conversion Funnel** - Visualize drop-off points using campaign templates as structure guide
```bash
cat ../../marketing-skill/marketing-demand-acquisition/references/campaign-templates.md
cat ../../marketing-skill/skills/marketing-demand-acquisition/references/campaign-templates.md
```
4. **Identify Bottlenecks** - Analyze conversion rates at each funnel stage:
- Awareness → Interest (CTR)
@ -109,12 +109,12 @@ No asset templates currently available — use campaign-templates.md reference f
- Intent → Purchase/MQL (qualification rate)
5. **Reference Attribution Guide** - Review attribution models to identify problem areas
```bash
cat ../../marketing-skill/marketing-demand-acquisition/references/attribution-guide.md
cat ../../marketing-skill/skills/marketing-demand-acquisition/references/attribution-guide.md
```
6. **Implement A/B Tests** - Test hypotheses for improvement
7. **Re-calculate CAC Post-Optimization** - Measure cost efficiency improvements
```bash
python ../../marketing-skill/marketing-demand-acquisition/scripts/calculate_cac.py post-optimization-spend.csv post-optimization-conversions.csv
python ../../marketing-skill/skills/marketing-demand-acquisition/scripts/calculate_cac.py post-optimization-spend.csv post-optimization-conversions.csv
```
**Expected Output:** 15-30% reduction in CAC and improved LTV:CAC ratio
@ -124,7 +124,7 @@ No asset templates currently available — use campaign-templates.md reference f
**Example:**
```bash
# Complete CAC analysis workflow
python ../../marketing-skill/marketing-demand-acquisition/scripts/calculate_cac.py q3-spend.csv q3-conversions.csv > cac-report.txt
python ../../marketing-skill/skills/marketing-demand-acquisition/scripts/calculate_cac.py q3-spend.csv q3-conversions.csv > cac-report.txt
cat cac-report.txt
# Review metrics and optimize high-CAC channels
```
@ -142,11 +142,11 @@ cat cac-report.txt
- Email Campaigns (open rate, click rate, conversions)
2. **Run CAC Comparison** - Calculate and compare CAC across all channels
```bash
python ../../marketing-skill/marketing-demand-acquisition/scripts/calculate_cac.py channel-spend.csv channel-conversions.csv
python ../../marketing-skill/skills/marketing-demand-acquisition/scripts/calculate_cac.py channel-spend.csv channel-conversions.csv
```
3. **Reference Attribution Guide** - Understand attribution models and benchmarks for each channel
```bash
cat ../../marketing-skill/marketing-demand-acquisition/references/attribution-guide.md
cat ../../marketing-skill/skills/marketing-demand-acquisition/references/attribution-guide.md
```
4. **Calculate Key Metrics:**
- CAC (Customer Acquisition Cost) by channel
@ -168,7 +168,7 @@ cat cac-report.txt
1. **Define Lead Magnet** - Choose format: ebook, webinar, template, assessment, free trial
2. **Reference Campaign Templates** - Review lead capture and campaign structure best practices
```bash
cat ../../marketing-skill/marketing-demand-acquisition/references/campaign-templates.md
cat ../../marketing-skill/skills/marketing-demand-acquisition/references/campaign-templates.md
```
3. **Create Landing Page** - Design high-converting landing page with:
- Clear value proposition
@ -184,7 +184,7 @@ cat cac-report.txt
6. **Monitor and Optimize** - Track CAC and conversion metrics
```bash
# Weekly CAC analysis
python ../../marketing-skill/marketing-demand-acquisition/scripts/calculate_cac.py lead-magnet-spend.csv lead-magnet-conversions.csv
python ../../marketing-skill/skills/marketing-demand-acquisition/scripts/calculate_cac.py lead-magnet-spend.csv lead-magnet-conversions.csv
```
**Expected Output:** Lead magnet campaign generating 100-500 leads with 25-40% conversion rate
@ -205,7 +205,7 @@ echo "📊 Demand Gen Dashboard - $DATE"
echo "========================================"
# Calculate yesterday's CAC by channel
python ../../marketing-skill/marketing-demand-acquisition/scripts/calculate_cac.py \
python ../../marketing-skill/skills/marketing-demand-acquisition/scripts/calculate_cac.py \
daily-spend.csv daily-conversions.csv
echo ""
@ -221,7 +221,7 @@ cat optimization-priorities.txt
```bash
# Generate weekly CAC report for stakeholders
python ../../marketing-skill/marketing-demand-acquisition/scripts/calculate_cac.py \
python ../../marketing-skill/skills/marketing-demand-acquisition/scripts/calculate_cac.py \
weekly-spend.csv weekly-conversions.csv > weekly-cac-report.txt
# Email to stakeholders
@ -233,7 +233,7 @@ echo "Weekly CAC analysis report attached." | \
```bash
# Monitor CAC in real-time (run daily via cron)
CAC_RESULT=$(python ../../marketing-skill/marketing-demand-acquisition/scripts/calculate_cac.py \
CAC_RESULT=$(python ../../marketing-skill/skills/marketing-demand-acquisition/scripts/calculate_cac.py \
daily-spend.csv daily-conversions.csv | grep "Average CAC" | awk '{print $3}')
CAC_THRESHOLD=50
@ -277,7 +277,7 @@ fi
## References
- **Skill Documentation:** [../../marketing-skill/marketing-demand-acquisition/SKILL.md](../../marketing-skill/marketing-demand-acquisition/SKILL.md)
- **Skill Documentation:** [../../marketing-skill/skills/marketing-demand-acquisition/SKILL.md](../../marketing-skill/skills/marketing-demand-acquisition/SKILL.md)
- **Marketing Domain Guide:** [../../marketing-skill/CLAUDE.md](../../marketing-skill/CLAUDE.md)
- **Agent Development Guide:** [../CLAUDE.md](../CLAUDE.md)
- **Marketing Roadmap:** [../../marketing-skill/marketing_skills_roadmap.md](../../marketing-skill/marketing_skills_roadmap.md)

18
agents/marketing/cs-webinar-marketer.md
View file

@ -35,24 +35,24 @@ Distinct from:
## Skill Integration
- `marketing-skill/skills/webinar-marketing` — the full webinar funnel motion (plan / rescue / evergreen)
- `scripts/webinar_funnel_scorer.py` — scores a funnel 0-100 and names the weakest stage
- `references/webinar-formats.md` — format-to-goal fit (training, demo, panel, summit…)
- `references/promotion-playbook.md` — the promotion runway across the pre-event window
- `references/benchmarks.md` — stage-by-stage conversion benchmarks by audience temperature
- `templates/webinar-plan-template.md` — the deliverable plan skeleton
- `marketing-skill/skills/webinar-marketing/scripts/webinar_funnel_scorer.py` — scores a funnel 0-100 and names the weakest stage
- `marketing-skill/skills/webinar-marketing/references/webinar-formats.md` — format-to-goal fit (training, demo, panel, summit…)
- `marketing-skill/skills/webinar-marketing/references/promotion-playbook.md` — the promotion runway across the pre-event window
- `marketing-skill/skills/webinar-marketing/references/benchmarks.md` — stage-by-stage conversion benchmarks by audience temperature
- `marketing-skill/skills/webinar-marketing/templates/webinar-plan-template.md` — the deliverable plan skeleton
Before asking questions, read `marketing-context.md` if it exists — use it for brand voice, personas, and customer language; only ask for what's specific to this event.
## Core Workflows
### 1. Plan From Scratch (Mode 1)
1. Lock the single promise to the attendee, then pick the format that fits the goal (`references/webinar-formats.md`)
1. Lock the single promise to the attendee, then pick the format that fits the goal (`marketing-skill/skills/webinar-marketing/references/webinar-formats.md`)
2. Size the funnel backward from the business goal using realistic conversion rates (funnel math below)
3. Reality-check: if required visits exceed reachable audience, fix goal/format/budget *now*
4. Build the promotion plan across the runway (`references/promotion-playbook.md`)
4. Build the promotion plan across the runway (`marketing-skill/skills/webinar-marketing/references/promotion-playbook.md`)
5. Design the show-up sequence and the live-to-close moment
6. Plan segmented follow-up: attendees vs. no-shows
7. Deliver via `templates/webinar-plan-template.md` — full plan + promo calendar + email/copy drafts
7. Deliver via `marketing-skill/skills/webinar-marketing/templates/webinar-plan-template.md` — full plan + promo calendar + email/copy drafts
### 2. Optimize / Rescue (Mode 2)
1. Get the *actual* numbers: invited → registered → showed up → engaged → converted
@ -109,7 +109,7 @@ Input JSON (`registrations` + `attended_live` required; rest optional). `audienc
Returns an overall 0-100 score, per-stage rate vs. benchmark, and the named bottleneck.
## Output Standards
- Plans → use `templates/webinar-plan-template.md`; always include the backward funnel math
- Plans → use `marketing-skill/skills/webinar-marketing/templates/webinar-plan-template.md`; always include the backward funnel math
- Rescues → lead with the named bottleneck and the score, then ranked fixes
- Every deliverable states the audience temperature so benchmarks are interpreted correctly

68
agents/product/cs-agile-product-owner.md
View file

@ -26,53 +26,53 @@ The cs-agile-product-owner agent bridges strategic product goals with sprint-lev
| # | Skill | Location | Primary Tool |
|---|-------|----------|-------------|
| 1 | Agile Product Owner | `../../product-team/agile-product-owner/` | user_story_generator.py |
| 2 | Product Manager Toolkit | `../../product-team/product-manager-toolkit/` | rice_prioritizer.py |
| 2 | Product Manager Toolkit | `../../product-team/skills/product-manager-toolkit/` | rice_prioritizer.py |
### Python Tools
1. **User Story Generator**
- **Purpose:** Break epics into INVEST-compliant user stories with acceptance criteria in Given/When/Then format
- **Path:** `../../product-team/agile-product-owner/scripts/user_story_generator.py`
- **Usage:** `python ../../product-team/agile-product-owner/scripts/user_story_generator.py epic.yaml`
- **Path:** `../../product-team/agile-product-owner/skills/agile-product-owner/scripts/user_story_generator.py`
- **Usage:** `python ../../product-team/agile-product-owner/skills/agile-product-owner/scripts/user_story_generator.py epic.yaml`
- **Features:** Epic decomposition, acceptance criteria generation, story point estimation, dependency mapping
- **Use Cases:** Sprint planning, backlog refinement, story writing workshops
2. **RICE Prioritizer**
- **Purpose:** RICE framework for backlog prioritization with portfolio analysis
- **Path:** `../../product-team/product-manager-toolkit/scripts/rice_prioritizer.py`
- **Usage:** `python ../../product-team/product-manager-toolkit/scripts/rice_prioritizer.py backlog.csv --capacity 20`
- **Path:** `../../product-team/skills/product-manager-toolkit/scripts/rice_prioritizer.py`
- **Usage:** `python ../../product-team/skills/product-manager-toolkit/scripts/rice_prioritizer.py backlog.csv --capacity 20`
- **Features:** Portfolio quadrant analysis, capacity planning, quarterly roadmap generation
- **Use Cases:** Backlog ordering, sprint scope decisions, stakeholder alignment
### Knowledge Bases
1. **Sprint Planning Guide**
- **Location:** `../../product-team/agile-product-owner/references/sprint-planning-guide.md`
- **Location:** `../../product-team/agile-product-owner/skills/agile-product-owner/references/sprint-planning-guide.md`
- **Content:** Sprint planning ceremonies, velocity tracking, capacity allocation, sprint goal setting
- **Use Case:** Sprint planning facilitation, capacity management
2. **User Story Templates**
- **Location:** `../../product-team/agile-product-owner/references/user-story-templates.md`
- **Location:** `../../product-team/agile-product-owner/skills/agile-product-owner/references/user-story-templates.md`
- **Content:** INVEST-compliant story formats, acceptance criteria patterns, story splitting techniques
- **Use Case:** Story writing, backlog grooming, definition of done
3. **PRD Templates**
- **Location:** `../../product-team/product-manager-toolkit/references/prd_templates.md`
- **Location:** `../../product-team/skills/product-manager-toolkit/references/prd_templates.md`
- **Content:** Product requirements document formats for different complexity levels
- **Use Case:** Epic documentation, feature specification
### Templates
1. **Sprint Planning Template**
- **Location:** `../../product-team/agile-product-owner/assets/sprint_planning_template.md`
- **Location:** `../../product-team/agile-product-owner/skills/agile-product-owner/assets/sprint_planning_template.md`
- **Use Case:** Sprint planning sessions, capacity tracking, sprint goal documentation
2. **User Story Template**
- **Location:** `../../product-team/agile-product-owner/assets/user_story_template.md`
- **Location:** `../../product-team/agile-product-owner/skills/agile-product-owner/assets/user_story_template.md`
- **Use Case:** Consistent story format, acceptance criteria structure
3. **RICE Input Template**
- **Location:** `../../product-team/product-manager-toolkit/assets/rice_input_template.csv`
- **Location:** `../../product-team/skills/product-manager-toolkit/assets/rice_input_template.csv`
- **Use Case:** Structuring backlog items for RICE prioritization
## Workflows
@ -102,7 +102,7 @@ The cs-agile-product-owner agent bridges strategic product goals with sprint-lev
3. **Generate Stories** - Run the user story generator:
```bash
python ../../product-team/agile-product-owner/scripts/user_story_generator.py epic.yaml
python ../../product-team/agile-product-owner/skills/agile-product-owner/scripts/user_story_generator.py epic.yaml
```
4. **Review and Refine** - For each generated story:
@ -136,10 +136,10 @@ epic:
EOF
# Generate user stories
python ../../product-team/agile-product-owner/scripts/user_story_generator.py dashboard-epic.yaml
python ../../product-team/agile-product-owner/skills/agile-product-owner/scripts/user_story_generator.py dashboard-epic.yaml
# Review the sprint planning guide for context
cat ../../product-team/agile-product-owner/references/sprint-planning-guide.md
cat ../../product-team/agile-product-owner/skills/agile-product-owner/references/sprint-planning-guide.md
```
### Workflow 2: Sprint Planning
@ -167,12 +167,12 @@ cat ../../product-team/agile-product-owner/references/sprint-planning-guide.md
4. **Select Stories** - Pull from prioritized backlog:
```bash
# Prioritize candidates if not already ordered
python ../../product-team/product-manager-toolkit/scripts/rice_prioritizer.py sprint-candidates.csv --capacity 12
python ../../product-team/skills/product-manager-toolkit/scripts/rice_prioritizer.py sprint-candidates.csv --capacity 12
```
5. **Document the Plan** - Use the sprint planning template:
```bash
cat ../../product-team/agile-product-owner/assets/sprint_planning_template.md
cat ../../product-team/agile-product-owner/skills/agile-product-owner/assets/sprint_planning_template.md
```
6. **Identify Risks** - Document potential blockers:
@ -197,10 +197,10 @@ Password Reset Flow Fix,1000,2,1.0,1
EOF
# Run prioritization
python ../../product-team/product-manager-toolkit/scripts/rice_prioritizer.py sprint-candidates.csv --capacity 8
python ../../product-team/skills/product-manager-toolkit/scripts/rice_prioritizer.py sprint-candidates.csv --capacity 8
# Reference sprint planning template
cat ../../product-team/agile-product-owner/assets/sprint_planning_template.md
cat ../../product-team/agile-product-owner/skills/agile-product-owner/assets/sprint_planning_template.md
```
### Workflow 3: Backlog Refinement
@ -222,7 +222,7 @@ cat ../../product-team/agile-product-owner/assets/sprint_planning_template.md
3. **Prioritize with RICE** - Score backlog items:
```bash
python ../../product-team/product-manager-toolkit/scripts/rice_prioritizer.py backlog.csv
python ../../product-team/skills/product-manager-toolkit/scripts/rice_prioritizer.py backlog.csv
```
4. **Refine Top Items** - Ensure top 2 sprints worth are ready:
@ -254,10 +254,10 @@ Dark Mode,300,1,0.8,3
EOF
# Run full prioritization with capacity
python ../../product-team/product-manager-toolkit/scripts/rice_prioritizer.py backlog-q2.csv --capacity 15
python ../../product-team/skills/product-manager-toolkit/scripts/rice_prioritizer.py backlog-q2.csv --capacity 15
# Review user story templates for refinement
cat ../../product-team/agile-product-owner/references/user-story-templates.md
cat ../../product-team/agile-product-owner/skills/agile-product-owner/references/user-story-templates.md
```
### Workflow 4: Story Writing Workshop
@ -278,7 +278,7 @@ cat ../../product-team/agile-product-owner/references/user-story-templates.md
3. **Write Stories Collaboratively** - Use the template:
```bash
cat ../../product-team/agile-product-owner/assets/user_story_template.md
cat ../../product-team/agile-product-owner/skills/agile-product-owner/assets/user_story_template.md
```
- "As a [persona], I want [capability], so that [benefit]"
- Focus on user value, not implementation details
@ -309,13 +309,13 @@ cat ../../product-team/agile-product-owner/references/user-story-templates.md
**Example:**
```bash
# Generate initial story candidates from epic
python ../../product-team/agile-product-owner/scripts/user_story_generator.py feature-epic.yaml
python ../../product-team/agile-product-owner/skills/agile-product-owner/scripts/user_story_generator.py feature-epic.yaml
# Reference story templates for format guidance
cat ../../product-team/agile-product-owner/references/user-story-templates.md
cat ../../product-team/agile-product-owner/skills/agile-product-owner/references/user-story-templates.md
# Reference sprint planning guide for estimation practices
cat ../../product-team/agile-product-owner/references/sprint-planning-guide.md
cat ../../product-team/agile-product-owner/skills/agile-product-owner/references/sprint-planning-guide.md
```
## Integration Examples
@ -335,17 +335,17 @@ echo "=========================="
# Step 1: Prioritize backlog
echo ""
echo "1. Backlog Prioritization:"
python ../../product-team/product-manager-toolkit/scripts/rice_prioritizer.py backlog.csv --capacity $CAPACITY
python ../../product-team/skills/product-manager-toolkit/scripts/rice_prioritizer.py backlog.csv --capacity $CAPACITY
# Step 2: Generate stories for top epic
echo ""
echo "2. Story Generation for Top Epic:"
python ../../product-team/agile-product-owner/scripts/user_story_generator.py top-epic.yaml
python ../../product-team/agile-product-owner/skills/agile-product-owner/scripts/user_story_generator.py top-epic.yaml
# Step 3: Reference planning template
echo ""
echo "3. Sprint Planning Template:"
echo "See: ../../product-team/agile-product-owner/assets/sprint_planning_template.md"
echo "See: ../../product-team/agile-product-owner/skills/agile-product-owner/assets/sprint_planning_template.md"
```
### Example 2: Backlog Health Check
@ -366,12 +366,12 @@ echo "items in backlog"
# Run prioritization
echo ""
echo "Current Priorities:"
python ../../product-team/product-manager-toolkit/scripts/rice_prioritizer.py backlog.csv --capacity 20
python ../../product-team/skills/product-manager-toolkit/scripts/rice_prioritizer.py backlog.csv --capacity 20
# Check story templates
echo ""
echo "Story Template Reference:"
echo "Location: ../../product-team/agile-product-owner/references/user-story-templates.md"
echo "Location: ../../product-team/agile-product-owner/skills/agile-product-owner/references/user-story-templates.md"
```
## Success Metrics
@ -399,15 +399,15 @@ echo "Location: ../../product-team/agile-product-owner/references/user-story-tem
- [cs-product-manager](cs-product-manager.md) - Full product management lifecycle (RICE, interviews, PRDs)
- [cs-product-strategist](cs-product-strategist.md) - OKR cascade and strategic planning for roadmap alignment
- [cs-ux-researcher](cs-ux-researcher.md) - User research to inform story requirements and acceptance criteria
- Scrum Master - Velocity context and sprint execution (see `../../project-management/scrum-master/`)
- Scrum Master - Velocity context and sprint execution (see `../../project-management/skills/scrum-master/`)
## References
- **Primary Skill:** [../../product-team/agile-product-owner/SKILL.md](../../product-team/agile-product-owner/SKILL.md)
- **RICE Framework:** [../../product-team/product-manager-toolkit/SKILL.md](../../product-team/product-manager-toolkit/SKILL.md)
- **Primary Skill:** [../../product-team/agile-product-owner/skills/agile-product-owner/SKILL.md](../../product-team/agile-product-owner/skills/agile-product-owner/SKILL.md)
- **RICE Framework:** [../../product-team/skills/product-manager-toolkit/SKILL.md](../../product-team/skills/product-manager-toolkit/SKILL.md)
- **Product Domain Guide:** [../../product-team/CLAUDE.md](../../product-team/CLAUDE.md)
- **Agent Development Guide:** [../CLAUDE.md](../CLAUDE.md)
- **Scrum Master Skill:** [../../project-management/scrum-master/SKILL.md](../../project-management/scrum-master/SKILL.md)
- **Scrum Master Skill:** [../../project-management/skills/scrum-master/SKILL.md](../../project-management/skills/scrum-master/SKILL.md)
---

8
agents/product/cs-product-analyst.md
View file

@ -12,8 +12,8 @@ tools: [Read, Write, Bash, Grep, Glob]
# Product Analyst Agent
## Skill Links
- `../../product-team/product-analytics/SKILL.md`
- `../../product-team/experiment-designer/SKILL.md`
- `../../product-team/skills/product-analytics/SKILL.md`
- `../../product-team/skills/experiment-designer/SKILL.md`
## Primary Workflows
1. Metric framework and KPI definition
@ -22,8 +22,8 @@ tools: [Read, Write, Bash, Grep, Glob]
4. Result interpretation and decision recommendations
## Tooling
- `../../product-team/product-analytics/scripts/metrics_calculator.py`
- `../../product-team/experiment-designer/scripts/sample_size_calculator.py`
- `../../product-team/skills/product-analytics/scripts/metrics_calculator.py`
- `../../product-team/skills/experiment-designer/scripts/sample_size_calculator.py`
## Usage Notes
- Define decision metrics before analysis to avoid post-hoc bias.

154
agents/product/cs-product-manager.md
View file

@ -19,144 +19,144 @@ The cs-product-manager agent bridges the gap between customer insights and produ
## Skill Integration
**Primary Skill:** `../../product-team/product-manager-toolkit/`
**Primary Skill:** `../../product-team/skills/product-manager-toolkit/`
### All Orchestrated Skills
| # | Skill | Location | Primary Tool |
|---|-------|----------|-------------|
| 1 | Product Manager Toolkit | `../../product-team/product-manager-toolkit/` | rice_prioritizer.py, customer_interview_analyzer.py |
| 1 | Product Manager Toolkit | `../../product-team/skills/product-manager-toolkit/` | rice_prioritizer.py, customer_interview_analyzer.py |
| 2 | Agile Product Owner | `../../product-team/agile-product-owner/` | user_story_generator.py |
| 3 | Product Strategist | `../../product-team/product-strategist/` | okr_cascade_generator.py |
| 4 | UX Researcher & Designer | `../../product-team/ux-researcher-designer/` | persona_generator.py |
| 5 | UI Design System | `../../product-team/ui-design-system/` | design_token_generator.py |
| 6 | Competitive Teardown | `../../product-team/competitive-teardown/` | competitive_matrix_builder.py |
| 7 | Landing Page Generator | `../../product-team/landing-page-generator/` | landing_page_scaffolder.py |
| 8 | SaaS Scaffolder | `../../product-team/saas-scaffolder/` | project_bootstrapper.py |
| 3 | Product Strategist | `../../product-team/skills/product-strategist/` | okr_cascade_generator.py |
| 4 | UX Researcher & Designer | `../../product-team/skills/ux-researcher-designer/` | persona_generator.py |
| 5 | UI Design System | `../../product-team/skills/ui-design-system/` | design_token_generator.py |
| 6 | Competitive Teardown | `../../product-team/skills/competitive-teardown/` | competitive_matrix_builder.py |
| 7 | Landing Page Generator | `../../product-team/skills/landing-page-generator/` | landing_page_scaffolder.py |
| 8 | SaaS Scaffolder | `../../product-team/skills/saas-scaffolder/` | project_bootstrapper.py |
### Python Tools
1. **RICE Prioritizer**
- **Purpose:** RICE framework implementation for feature prioritization with portfolio analysis and capacity planning
- **Path:** `../../product-team/product-manager-toolkit/scripts/rice_prioritizer.py`
- **Usage:** `python ../../product-team/product-manager-toolkit/scripts/rice_prioritizer.py features.csv --capacity 20`
- **Path:** `../../product-team/skills/product-manager-toolkit/scripts/rice_prioritizer.py`
- **Usage:** `python ../../product-team/skills/product-manager-toolkit/scripts/rice_prioritizer.py features.csv --capacity 20`
- **Formula:** RICE Score = (Reach × Impact × Confidence) / Effort
- **Features:** Portfolio analysis (quick wins vs big bets), quarterly roadmap generation, capacity planning, JSON/CSV export
- **Use Cases:** Feature prioritization, roadmap planning, stakeholder alignment, resource allocation
2. **Customer Interview Analyzer**
- **Purpose:** NLP-based interview transcript analysis to extract pain points, feature requests, and themes
- **Path:** `../../product-team/product-manager-toolkit/scripts/customer_interview_analyzer.py`
- **Usage:** `python ../../product-team/product-manager-toolkit/scripts/customer_interview_analyzer.py interview.txt`
- **Path:** `../../product-team/skills/product-manager-toolkit/scripts/customer_interview_analyzer.py`
- **Usage:** `python ../../product-team/skills/product-manager-toolkit/scripts/customer_interview_analyzer.py interview.txt`
- **Features:** Pain point extraction with severity, feature request identification, jobs-to-be-done patterns, sentiment analysis, theme extraction
- **Use Cases:** User research synthesis, discovery validation, problem prioritization, insight generation
3. **User Story Generator**
- **Purpose:** Break epics into INVEST-compliant user stories with acceptance criteria
- **Path:** `../../product-team/agile-product-owner/scripts/user_story_generator.py`
- **Usage:** `python ../../product-team/agile-product-owner/scripts/user_story_generator.py epic.yaml`
- **Path:** `../../product-team/agile-product-owner/skills/agile-product-owner/scripts/user_story_generator.py`
- **Usage:** `python ../../product-team/agile-product-owner/skills/agile-product-owner/scripts/user_story_generator.py epic.yaml`
- **Use Cases:** Sprint planning, backlog refinement, story decomposition
4. **OKR Cascade Generator**
- **Purpose:** Generate cascaded OKRs from company objectives to team-level key results
- **Path:** `../../product-team/product-strategist/scripts/okr_cascade_generator.py`
- **Usage:** `python ../../product-team/product-strategist/scripts/okr_cascade_generator.py growth`
- **Path:** `../../product-team/skills/product-strategist/scripts/okr_cascade_generator.py`
- **Usage:** `python ../../product-team/skills/product-strategist/scripts/okr_cascade_generator.py growth`
- **Use Cases:** Quarterly planning, strategic alignment, goal setting
5. **Persona Generator**
- **Purpose:** Create data-driven user personas from research inputs
- **Path:** `../../product-team/ux-researcher-designer/scripts/persona_generator.py`
- **Usage:** `python ../../product-team/ux-researcher-designer/scripts/persona_generator.py research-data.json`
- **Path:** `../../product-team/skills/ux-researcher-designer/scripts/persona_generator.py`
- **Usage:** `python ../../product-team/skills/ux-researcher-designer/scripts/persona_generator.py research-data.json`
- **Use Cases:** User research synthesis, persona development, journey mapping
6. **Design Token Generator**
- **Purpose:** Generate design tokens for consistent UI implementation
- **Path:** `../../product-team/ui-design-system/scripts/design_token_generator.py`
- **Usage:** `python ../../product-team/ui-design-system/scripts/design_token_generator.py theme.json`
- **Path:** `../../product-team/skills/ui-design-system/scripts/design_token_generator.py`
- **Usage:** `python ../../product-team/skills/ui-design-system/scripts/design_token_generator.py theme.json`
- **Use Cases:** Design system creation, developer handoff, theming
7. **Competitive Matrix Builder**
- **Purpose:** Build competitive analysis matrices and feature comparison grids
- **Path:** `../../product-team/competitive-teardown/scripts/competitive_matrix_builder.py`
- **Usage:** `python ../../product-team/competitive-teardown/scripts/competitive_matrix_builder.py competitors.csv`
- **Path:** `../../product-team/skills/competitive-teardown/scripts/competitive_matrix_builder.py`
- **Usage:** `python ../../product-team/skills/competitive-teardown/scripts/competitive_matrix_builder.py competitors.csv`
- **Use Cases:** Competitive intelligence, market positioning, feature gap analysis
8. **Landing Page Scaffolder**
- **Purpose:** Generate conversion-optimized landing page scaffolds
- **Path:** `../../product-team/landing-page-generator/scripts/landing_page_scaffolder.py`
- **Usage:** `python ../../product-team/landing-page-generator/scripts/landing_page_scaffolder.py config.yaml`
- **Path:** `../../product-team/skills/landing-page-generator/scripts/landing_page_scaffolder.py`
- **Usage:** `python ../../product-team/skills/landing-page-generator/scripts/landing_page_scaffolder.py config.yaml`
- **Use Cases:** Product launches, A/B testing, GTM campaigns
9. **Project Bootstrapper**
- **Purpose:** Scaffold SaaS project structures with boilerplate and configurations
- **Path:** `../../product-team/saas-scaffolder/scripts/project_bootstrapper.py`
- **Usage:** `python ../../product-team/saas-scaffolder/scripts/project_bootstrapper.py --stack nextjs --name my-saas`
- **Path:** `../../product-team/skills/saas-scaffolder/scripts/project_bootstrapper.py`
- **Usage:** `python ../../product-team/skills/saas-scaffolder/scripts/project_bootstrapper.py --stack nextjs --name my-saas`
- **Use Cases:** MVP scaffolding, project kickoff, SaaS prototype creation
### Knowledge Bases
1. **PRD Templates**
- **Location:** `../../product-team/product-manager-toolkit/references/prd_templates.md`
- **Location:** `../../product-team/skills/product-manager-toolkit/references/prd_templates.md`
- **Content:** Multiple PRD formats (Standard PRD, One-Page PRD, Feature Brief, Agile Epic), structure guidelines, best practices
- **Use Case:** Requirements documentation, stakeholder communication, engineering handoff
2. **Sprint Planning Guide**
- **Location:** `../../product-team/agile-product-owner/references/sprint-planning-guide.md`
- **Location:** `../../product-team/agile-product-owner/skills/agile-product-owner/references/sprint-planning-guide.md`
- **Content:** Sprint planning ceremonies, velocity tracking, capacity allocation
- **Use Case:** Sprint execution, backlog refinement, agile ceremonies
3. **User Story Templates**
- **Location:** `../../product-team/agile-product-owner/references/user-story-templates.md`
- **Location:** `../../product-team/agile-product-owner/skills/agile-product-owner/references/user-story-templates.md`
- **Content:** INVEST-compliant story formats, acceptance criteria patterns, story splitting techniques
- **Use Case:** Story writing, backlog grooming, definition of done
4. **OKR Framework**
- **Location:** `../../product-team/product-strategist/references/okr_framework.md`
- **Location:** `../../product-team/skills/product-strategist/references/okr_framework.md`
- **Content:** OKR methodology, cascade patterns, scoring guidelines
- **Use Case:** Quarterly planning, strategic alignment, goal tracking
5. **Strategy Types**
- **Location:** `../../product-team/product-strategist/references/strategy_types.md`
- **Location:** `../../product-team/skills/product-strategist/references/strategy_types.md`
- **Content:** Product strategy frameworks, competitive positioning, growth strategies
- **Use Case:** Strategic planning, market analysis, product vision
6. **Persona Methodology**
- **Location:** `../../product-team/ux-researcher-designer/references/persona-methodology.md`
- **Location:** `../../product-team/skills/ux-researcher-designer/references/persona-methodology.md`
- **Content:** Research-backed persona creation methodology, data collection, validation
- **Use Case:** Persona development, user segmentation, research planning
7. **Example Personas**
- **Location:** `../../product-team/ux-researcher-designer/references/example-personas.md`
- **Location:** `../../product-team/skills/ux-researcher-designer/references/example-personas.md`
- **Content:** Sample persona documents with demographics, goals, pain points, behaviors
- **Use Case:** Persona templates, research documentation
8. **Journey Mapping Guide**
- **Location:** `../../product-team/ux-researcher-designer/references/journey-mapping-guide.md`
- **Location:** `../../product-team/skills/ux-researcher-designer/references/journey-mapping-guide.md`
- **Content:** Customer journey mapping methodology, touchpoint analysis, emotion mapping
- **Use Case:** Experience design, touchpoint optimization, service design
9. **Usability Testing Frameworks**
- **Location:** `../../product-team/ux-researcher-designer/references/usability-testing-frameworks.md`
- **Location:** `../../product-team/skills/ux-researcher-designer/references/usability-testing-frameworks.md`
- **Content:** Usability test planning, task design, analysis methods
- **Use Case:** Usability studies, prototype validation, UX evaluation
10. **Component Architecture**
- **Location:** `../../product-team/ui-design-system/references/component-architecture.md`
- **Location:** `../../product-team/skills/ui-design-system/references/component-architecture.md`
- **Content:** Component hierarchy, atomic design patterns, composition strategies
- **Use Case:** Design system architecture, component libraries
11. **Developer Handoff**
- **Location:** `../../product-team/ui-design-system/references/developer-handoff.md`
- **Location:** `../../product-team/skills/ui-design-system/references/developer-handoff.md`
- **Content:** Design-to-dev handoff process, specification formats, asset delivery
- **Use Case:** Engineering collaboration, implementation specs
12. **Responsive Calculations**
- **Location:** `../../product-team/ui-design-system/references/responsive-calculations.md`
- **Location:** `../../product-team/skills/ui-design-system/references/responsive-calculations.md`
- **Content:** Responsive design formulas, breakpoint strategies, fluid typography
- **Use Case:** Responsive implementation, cross-device design
13. **Token Generation**
- **Location:** `../../product-team/ui-design-system/references/token-generation.md`
- **Location:** `../../product-team/skills/ui-design-system/references/token-generation.md`
- **Content:** Design token standards, naming conventions, platform-specific output
- **Use Case:** Design system tokens, theming, multi-platform consistency
@ -188,7 +188,7 @@ The cs-product-manager agent bridges the gap between customer insights and produ
3. **Run RICE Prioritization** - Execute analysis with team capacity
```bash
python ../../product-team/product-manager-toolkit/scripts/rice_prioritizer.py features.csv --capacity 20
python ../../product-team/skills/product-manager-toolkit/scripts/rice_prioritizer.py features.csv --capacity 20
```
4. **Analyze Portfolio** - Review output for:
@ -214,7 +214,7 @@ The cs-product-manager agent bridges the gap between customer insights and produ
**Example:**
```bash
# Complete prioritization workflow
python ../../product-team/product-manager-toolkit/scripts/rice_prioritizer.py q4-features.csv --capacity 20 > roadmap.txt
python ../../product-team/skills/product-manager-toolkit/scripts/rice_prioritizer.py q4-features.csv --capacity 20 > roadmap.txt
cat roadmap.txt
# Review quick wins, big bets, and generate quarterly plan
```
@ -240,7 +240,7 @@ cat roadmap.txt
3. **Run Interview Analyzer** - Extract structured insights
```bash
python ../../product-team/product-manager-toolkit/scripts/customer_interview_analyzer.py interview-001.txt
python ../../product-team/skills/product-manager-toolkit/scripts/customer_interview_analyzer.py interview-001.txt
```
4. **Review Analysis Output** - Study extracted insights:
@ -254,9 +254,9 @@ cat roadmap.txt
5. **Synthesize Across Interviews** - Aggregate insights:
```bash
# Analyze multiple interviews
python ../../product-team/product-manager-toolkit/scripts/customer_interview_analyzer.py interview-001.txt json > insights-001.json
python ../../product-team/product-manager-toolkit/scripts/customer_interview_analyzer.py interview-002.txt json > insights-002.json
python ../../product-team/product-manager-toolkit/scripts/customer_interview_analyzer.py interview-003.txt json > insights-003.json
python ../../product-team/skills/product-manager-toolkit/scripts/customer_interview_analyzer.py interview-001.txt json > insights-001.json
python ../../product-team/skills/product-manager-toolkit/scripts/customer_interview_analyzer.py interview-002.txt json > insights-002.json
python ../../product-team/skills/product-manager-toolkit/scripts/customer_interview_analyzer.py interview-003.txt json > insights-003.json
# Aggregate JSON files to find patterns
```
@ -282,7 +282,7 @@ cat roadmap.txt
**Steps:**
1. **Choose PRD Template** - Select based on complexity:
```bash
cat ../../product-team/product-manager-toolkit/references/prd_templates.md
cat ../../product-team/skills/product-manager-toolkit/references/prd_templates.md
```
- **Standard PRD**: Complex features (6-8 weeks dev)
- **One-Page PRD**: Simple features (2-4 weeks)
@ -341,12 +341,12 @@ cat roadmap.txt
2. **Run Feature Prioritization** - Use RICE for candidate features
```bash
python ../../product-team/product-manager-toolkit/scripts/rice_prioritizer.py q4-candidates.csv --capacity 18
python ../../product-team/skills/product-manager-toolkit/scripts/rice_prioritizer.py q4-candidates.csv --capacity 18
```
3. **Generate OKR Cascade** - Use the OKR cascade generator to create aligned objectives
```bash
python ../../product-team/product-strategist/scripts/okr_cascade_generator.py growth
python ../../product-team/skills/product-strategist/scripts/okr_cascade_generator.py growth
```
4. **Define Product OKRs** - Set ambitious but achievable goals:
@ -396,22 +396,22 @@ cat roadmap.txt
2. **Review Persona Methodology** - Understand research-backed persona creation
```bash
cat ../../product-team/ux-researcher-designer/references/persona-methodology.md
cat ../../product-team/skills/ux-researcher-designer/references/persona-methodology.md
```
3. **Generate Personas** - Create structured personas from research inputs
```bash
python ../../product-team/ux-researcher-designer/scripts/persona_generator.py research-data.json
python ../../product-team/skills/ux-researcher-designer/scripts/persona_generator.py research-data.json
```
4. **Map Customer Journeys** - Reference journey mapping guide for each persona
```bash
cat ../../product-team/ux-researcher-designer/references/journey-mapping-guide.md
cat ../../product-team/skills/ux-researcher-designer/references/journey-mapping-guide.md
```
5. **Review Example Personas** - Compare output against proven persona formats
```bash
cat ../../product-team/ux-researcher-designer/references/example-personas.md
cat ../../product-team/skills/ux-researcher-designer/references/example-personas.md
```
6. **Validate and Iterate** - Share personas with stakeholders:
@ -426,13 +426,13 @@ cat roadmap.txt
**Example:**
```bash
# Complete persona generation workflow
python ../../product-team/ux-researcher-designer/scripts/persona_generator.py user-research-q4.json > personas.md
python ../../product-team/skills/ux-researcher-designer/scripts/persona_generator.py user-research-q4.json > personas.md
# Cross-reference with interview analysis
python ../../product-team/product-manager-toolkit/scripts/customer_interview_analyzer.py interviews-batch.txt > insights.txt
python ../../product-team/skills/product-manager-toolkit/scripts/customer_interview_analyzer.py interviews-batch.txt > insights.txt
# Review journey mapping methodology
cat ../../product-team/ux-researcher-designer/references/journey-mapping-guide.md
cat ../../product-team/skills/ux-researcher-designer/references/journey-mapping-guide.md
```
### Workflow 6: Sprint Story Generation
@ -448,17 +448,17 @@ cat ../../product-team/ux-researcher-designer/references/journey-mapping-guide.m
2. **Review Story Templates** - Load INVEST-compliant story patterns
```bash
cat ../../product-team/agile-product-owner/references/user-story-templates.md
cat ../../product-team/agile-product-owner/skills/agile-product-owner/references/user-story-templates.md
```
3. **Generate User Stories** - Break the epic into sprint-sized stories
```bash
python ../../product-team/agile-product-owner/scripts/user_story_generator.py epic.yaml
python ../../product-team/agile-product-owner/skills/agile-product-owner/scripts/user_story_generator.py epic.yaml
```
4. **Review Sprint Planning Guide** - Ensure stories fit sprint capacity
```bash
cat ../../product-team/agile-product-owner/references/sprint-planning-guide.md
cat ../../product-team/agile-product-owner/skills/agile-product-owner/references/sprint-planning-guide.md
```
5. **Refine and Estimate** - Groom generated stories:
@ -469,7 +469,7 @@ cat ../../product-team/ux-researcher-designer/references/journey-mapping-guide.m
6. **Prioritize for Sprint** - Use RICE scores to sequence stories
```bash
python ../../product-team/product-manager-toolkit/scripts/rice_prioritizer.py sprint-stories.csv --capacity 8
python ../../product-team/skills/product-manager-toolkit/scripts/rice_prioritizer.py sprint-stories.csv --capacity 8
```
**Expected Output:** Sprint-ready backlog of INVEST-compliant user stories with acceptance criteria, story points, and priority order
@ -479,13 +479,13 @@ cat ../../product-team/ux-researcher-designer/references/journey-mapping-guide.m
**Example:**
```bash
# End-to-end story generation workflow
python ../../product-team/agile-product-owner/scripts/user_story_generator.py onboarding-epic.yaml > stories.md
python ../../product-team/agile-product-owner/skills/agile-product-owner/scripts/user_story_generator.py onboarding-epic.yaml > stories.md
# Prioritize stories for sprint
python ../../product-team/product-manager-toolkit/scripts/rice_prioritizer.py stories.csv --capacity 8 > sprint-plan.txt
python ../../product-team/skills/product-manager-toolkit/scripts/rice_prioritizer.py stories.csv --capacity 8 > sprint-plan.txt
# Review sprint planning best practices
cat ../../product-team/agile-product-owner/references/sprint-planning-guide.md
cat ../../product-team/agile-product-owner/skills/agile-product-owner/references/sprint-planning-guide.md
```
### Workflow 7: Competitive Intelligence
@ -508,7 +508,7 @@ cat ../../product-team/agile-product-owner/references/sprint-planning-guide.md
3. **Build Competitive Matrix** - Generate visual comparison
```bash
python ../../product-team/competitive-teardown/scripts/competitive_matrix_builder.py competitors.csv
python ../../product-team/skills/competitive-teardown/scripts/competitive_matrix_builder.py competitors.csv
```
4. **Analyze Gaps** - Identify strategic opportunities:
@ -520,7 +520,7 @@ cat ../../product-team/agile-product-owner/references/sprint-planning-guide.md
5. **Feed Into Prioritization** - Use gaps to inform roadmap
```bash
# Add competitive gap features to RICE analysis
python ../../product-team/product-manager-toolkit/scripts/rice_prioritizer.py competitive-features.csv --capacity 20
python ../../product-team/skills/product-manager-toolkit/scripts/rice_prioritizer.py competitive-features.csv --capacity 20
```
6. **Track Over Time** - Update competitive matrix quarterly:
@ -535,10 +535,10 @@ cat ../../product-team/agile-product-owner/references/sprint-planning-guide.md
**Example:**
```bash
# Full competitive intelligence workflow
python ../../product-team/competitive-teardown/scripts/competitive_matrix_builder.py q4-competitors.csv > competitive-matrix.md
python ../../product-team/skills/competitive-teardown/scripts/competitive_matrix_builder.py q4-competitors.csv > competitive-matrix.md
# Prioritize competitive gap features
python ../../product-team/product-manager-toolkit/scripts/rice_prioritizer.py gap-features.csv --capacity 12 > competitive-roadmap.txt
python ../../product-team/skills/product-manager-toolkit/scripts/rice_prioritizer.py gap-features.csv --capacity 12 > competitive-roadmap.txt
```
## Integration Examples
@ -555,13 +555,13 @@ echo "=========================================="
# Current roadmap status
echo ""
echo "🎯 Roadmap Priorities (RICE Sorted):"
python ../../product-team/product-manager-toolkit/scripts/rice_prioritizer.py current-roadmap.csv --capacity 20
python ../../product-team/skills/product-manager-toolkit/scripts/rice_prioritizer.py current-roadmap.csv --capacity 20
# Recent interview insights
echo ""
echo "💡 Latest Customer Insights:"
if [ -f latest-interview.txt ]; then
python ../../product-team/product-manager-toolkit/scripts/customer_interview_analyzer.py latest-interview.txt
python ../../product-team/skills/product-manager-toolkit/scripts/customer_interview_analyzer.py latest-interview.txt
else
echo "No new interviews this week"
fi
@ -570,7 +570,7 @@ fi
echo ""
echo "📝 PRD Templates:"
echo "Standard PRD, One-Page PRD, Feature Brief, Agile Epic"
echo "Location: ../../product-team/product-manager-toolkit/references/prd_templates.md"
echo "Location: ../../product-team/skills/product-manager-toolkit/references/prd_templates.md"
```
### Example 2: Discovery Sprint Workflow
@ -585,11 +585,11 @@ echo "=============================="
echo "Conducting 5 customer interviews..."
# Day 3-5: Analyze insights
python ../../product-team/product-manager-toolkit/scripts/customer_interview_analyzer.py interview-001.txt > insights-001.txt
python ../../product-team/product-manager-toolkit/scripts/customer_interview_analyzer.py interview-002.txt > insights-002.txt
python ../../product-team/product-manager-toolkit/scripts/customer_interview_analyzer.py interview-003.txt > insights-003.txt
python ../../product-team/product-manager-toolkit/scripts/customer_interview_analyzer.py interview-004.txt > insights-004.txt
python ../../product-team/product-manager-toolkit/scripts/customer_interview_analyzer.py interview-005.txt > insights-005.txt
python ../../product-team/skills/product-manager-toolkit/scripts/customer_interview_analyzer.py interview-001.txt > insights-001.txt
python ../../product-team/skills/product-manager-toolkit/scripts/customer_interview_analyzer.py interview-002.txt > insights-002.txt
python ../../product-team/skills/product-manager-toolkit/scripts/customer_interview_analyzer.py interview-003.txt > insights-003.txt
python ../../product-team/skills/product-manager-toolkit/scripts/customer_interview_analyzer.py interview-004.txt > insights-004.txt
python ../../product-team/skills/product-manager-toolkit/scripts/customer_interview_analyzer.py interview-005.txt > insights-005.txt
echo ""
echo "🔍 Discovery Sprint - Week 2"
@ -599,7 +599,7 @@ echo "=============================="
echo "Creating solution candidates..."
# Day 9-10: RICE prioritization
python ../../product-team/product-manager-toolkit/scripts/rice_prioritizer.py solution-candidates.csv
python ../../product-team/skills/product-manager-toolkit/scripts/rice_prioritizer.py solution-candidates.csv
echo ""
echo "✅ Discovery Complete - Ready for PRD creation"
@ -619,7 +619,7 @@ echo "===================="
# Step 1: Prioritize backlog
echo ""
echo "1. Feature Prioritization:"
python ../../product-team/product-manager-toolkit/scripts/rice_prioritizer.py backlog.csv --capacity $CAPACITY > $QUARTER-roadmap.txt
python ../../product-team/skills/product-manager-toolkit/scripts/rice_prioritizer.py backlog.csv --capacity $CAPACITY > $QUARTER-roadmap.txt
# Step 2: Extract quick wins
echo ""
@ -673,7 +673,7 @@ echo "Report: $QUARTER-roadmap.txt"
## References
- **Skill Documentation:** [../../product-team/product-manager-toolkit/SKILL.md](../../product-team/product-manager-toolkit/SKILL.md)
- **Skill Documentation:** [../../product-team/skills/product-manager-toolkit/SKILL.md](../../product-team/skills/product-manager-toolkit/SKILL.md)
- **Product Domain Guide:** [../../product-team/CLAUDE.md](../../product-team/CLAUDE.md)
- **Agent Development Guide:** [../CLAUDE.md](../CLAUDE.md)

102
agents/product/cs-product-strategist.md
View file

@ -19,74 +19,74 @@ The cs-product-strategist agent operates at the intersection of business strateg
## Skill Integration
**Primary Skill:** `../../product-team/product-strategist/`
**Primary Skill:** `../../product-team/skills/product-strategist/`
### All Orchestrated Skills
| # | Skill | Location | Primary Tool |
|---|-------|----------|-------------|
| 1 | Product Strategist | `../../product-team/product-strategist/` | okr_cascade_generator.py |
| 2 | Competitive Teardown | `../../product-team/competitive-teardown/` | competitive_matrix_builder.py |
| 3 | Product Manager Toolkit | `../../product-team/product-manager-toolkit/` | rice_prioritizer.py |
| 1 | Product Strategist | `../../product-team/skills/product-strategist/` | okr_cascade_generator.py |
| 2 | Competitive Teardown | `../../product-team/skills/competitive-teardown/` | competitive_matrix_builder.py |
| 3 | Product Manager Toolkit | `../../product-team/skills/product-manager-toolkit/` | rice_prioritizer.py |
### Python Tools
1. **OKR Cascade Generator**
- **Purpose:** Generate cascaded OKRs from company objectives to team-level key results with initiative mapping
- **Path:** `../../product-team/product-strategist/scripts/okr_cascade_generator.py`
- **Usage:** `python ../../product-team/product-strategist/scripts/okr_cascade_generator.py growth`
- **Path:** `../../product-team/skills/product-strategist/scripts/okr_cascade_generator.py`
- **Usage:** `python ../../product-team/skills/product-strategist/scripts/okr_cascade_generator.py growth`
- **Features:** Multi-level cascade (company > product > team), initiative mapping, scoring framework, tracking cadence
- **Use Cases:** Quarterly planning, strategic alignment, goal setting, annual planning
2. **Competitive Matrix Builder**
- **Purpose:** Build competitive analysis matrices, feature comparison grids, and positioning maps
- **Path:** `../../product-team/competitive-teardown/scripts/competitive_matrix_builder.py`
- **Usage:** `python ../../product-team/competitive-teardown/scripts/competitive_matrix_builder.py competitors.csv`
- **Path:** `../../product-team/skills/competitive-teardown/scripts/competitive_matrix_builder.py`
- **Usage:** `python ../../product-team/skills/competitive-teardown/scripts/competitive_matrix_builder.py competitors.csv`
- **Features:** Multi-dimensional scoring, weighted comparison, gap analysis, positioning visualization
- **Use Cases:** Competitive intelligence, market positioning, feature gap analysis, strategic differentiation
3. **RICE Prioritizer**
- **Purpose:** Strategic initiative prioritization using RICE framework for portfolio-level decisions
- **Path:** `../../product-team/product-manager-toolkit/scripts/rice_prioritizer.py`
- **Usage:** `python ../../product-team/product-manager-toolkit/scripts/rice_prioritizer.py initiatives.csv --capacity 50`
- **Path:** `../../product-team/skills/product-manager-toolkit/scripts/rice_prioritizer.py`
- **Usage:** `python ../../product-team/skills/product-manager-toolkit/scripts/rice_prioritizer.py initiatives.csv --capacity 50`
- **Features:** Portfolio quadrant analysis (big bets, quick wins), capacity planning, strategic roadmap generation
- **Use Cases:** Initiative prioritization, resource allocation, strategic portfolio management
### Knowledge Bases
1. **OKR Framework**
- **Location:** `../../product-team/product-strategist/references/okr_framework.md`
- **Location:** `../../product-team/skills/product-strategist/references/okr_framework.md`
- **Content:** OKR methodology, cascade patterns, scoring guidelines, common pitfalls
- **Use Case:** OKR education, quarterly planning preparation
2. **Strategy Types**
- **Location:** `../../product-team/product-strategist/references/strategy_types.md`
- **Location:** `../../product-team/skills/product-strategist/references/strategy_types.md`
- **Content:** Product strategy frameworks, competitive positioning models, growth strategies
- **Use Case:** Strategy formulation, market analysis, product vision development
3. **Data Collection Guide**
- **Location:** `../../product-team/competitive-teardown/references/data-collection-guide.md`
- **Location:** `../../product-team/skills/competitive-teardown/references/data-collection-guide.md`
- **Content:** Sources and methods for gathering competitive intelligence ethically
- **Use Case:** Competitive research planning, data source identification
4. **Scoring Rubric**
- **Location:** `../../product-team/competitive-teardown/references/scoring-rubric.md`
- **Location:** `../../product-team/skills/competitive-teardown/references/scoring-rubric.md`
- **Content:** Standardized scoring criteria for competitive dimensions (1-10 scale)
- **Use Case:** Consistent competitor evaluation, bias mitigation
5. **Analysis Templates**
- **Location:** `../../product-team/competitive-teardown/references/analysis-templates.md`
- **Location:** `../../product-team/skills/competitive-teardown/references/analysis-templates.md`
- **Content:** SWOT, Porter's Five Forces, positioning maps, battle cards, win/loss analysis
- **Use Case:** Structured competitive analysis, sales enablement
### Templates
1. **OKR Template**
- **Location:** `../../product-team/product-strategist/assets/okr_template.md`
- **Location:** `../../product-team/skills/product-strategist/assets/okr_template.md`
- **Use Case:** Quarterly OKR documentation with tracking structure
2. **PRD Template**
- **Location:** `../../product-team/product-manager-toolkit/assets/prd_template.md`
- **Location:** `../../product-team/skills/product-manager-toolkit/assets/prd_template.md`
- **Use Case:** Documenting strategic initiatives as formal requirements
## Workflows
@ -105,7 +105,7 @@ The cs-product-strategist agent operates at the intersection of business strateg
2. **Analyze Market Context** - Understand external factors:
```bash
# Build competitive landscape
python ../../product-team/competitive-teardown/scripts/competitive_matrix_builder.py competitors.csv
python ../../product-team/skills/competitive-teardown/scripts/competitive_matrix_builder.py competitors.csv
```
- Review competitive movements from past quarter
- Identify market trends and opportunities
@ -114,7 +114,7 @@ The cs-product-strategist agent operates at the intersection of business strateg
3. **Generate OKR Cascade** - Create aligned objectives:
```bash
# Generate OKRs for growth strategy
python ../../product-team/product-strategist/scripts/okr_cascade_generator.py growth
python ../../product-team/skills/product-strategist/scripts/okr_cascade_generator.py growth
```
4. **Define Product Objectives** - Set 2-3 product objectives:
@ -130,7 +130,7 @@ The cs-product-strategist agent operates at the intersection of business strateg
6. **Map Initiatives to KRs** - Connect work to outcomes:
```bash
# Prioritize strategic initiatives
python ../../product-team/product-manager-toolkit/scripts/rice_prioritizer.py initiatives.csv --capacity 50
python ../../product-team/skills/product-manager-toolkit/scripts/rice_prioritizer.py initiatives.csv --capacity 50
```
7. **Stakeholder Alignment** - Present and iterate:
@ -140,7 +140,7 @@ The cs-product-strategist agent operates at the intersection of business strateg
8. **Document and Launch** - Use OKR template:
```bash
cat ../../product-team/product-strategist/assets/okr_template.md
cat ../../product-team/skills/product-strategist/assets/okr_template.md
```
**Expected Output:** Quarterly OKR document with 2-3 objectives, 8-12 key results, mapped initiatives, and stakeholder alignment
@ -154,16 +154,16 @@ echo "Q3 2026 OKR Planning"
echo "===================="
# Step 1: Competitive context
python ../../product-team/competitive-teardown/scripts/competitive_matrix_builder.py q3-competitors.csv
python ../../product-team/skills/competitive-teardown/scripts/competitive_matrix_builder.py q3-competitors.csv
# Step 2: Generate OKR cascade
python ../../product-team/product-strategist/scripts/okr_cascade_generator.py growth
python ../../product-team/skills/product-strategist/scripts/okr_cascade_generator.py growth
# Step 3: Prioritize initiatives
python ../../product-team/product-manager-toolkit/scripts/rice_prioritizer.py q3-initiatives.csv --capacity 45
python ../../product-team/skills/product-manager-toolkit/scripts/rice_prioritizer.py q3-initiatives.csv --capacity 45
# Step 4: Review OKR template
cat ../../product-team/product-strategist/assets/okr_template.md
cat ../../product-team/skills/product-strategist/assets/okr_template.md
```
### Workflow 2: Competitive Landscape Review
@ -178,7 +178,7 @@ cat ../../product-team/product-strategist/assets/okr_template.md
2. **Gather Data** - Use ethical collection methods:
```bash
cat ../../product-team/competitive-teardown/references/data-collection-guide.md
cat ../../product-team/skills/competitive-teardown/references/data-collection-guide.md
```
- Public sources: G2, Capterra, pricing pages, changelogs
- Market reports: Gartner, Forrester, analyst briefings
@ -186,7 +186,7 @@ cat ../../product-team/product-strategist/assets/okr_template.md
3. **Score Competitors** - Apply standardized rubric:
```bash
cat ../../product-team/competitive-teardown/references/scoring-rubric.md
cat ../../product-team/skills/competitive-teardown/references/scoring-rubric.md
```
- Score across 7 dimensions (UX, features, pricing, integrations, support, performance, security)
- Use multiple scorers to reduce bias
@ -194,7 +194,7 @@ cat ../../product-team/product-strategist/assets/okr_template.md
4. **Build Competitive Matrix** - Generate comparison:
```bash
python ../../product-team/competitive-teardown/scripts/competitive_matrix_builder.py competitors-scored.csv
python ../../product-team/skills/competitive-teardown/scripts/competitive_matrix_builder.py competitors-scored.csv
```
5. **Identify Gaps and Opportunities** - Analyze the matrix:
@ -204,7 +204,7 @@ cat ../../product-team/product-strategist/assets/okr_template.md
6. **Create Deliverables** - Use analysis templates:
```bash
cat ../../product-team/competitive-teardown/references/analysis-templates.md
cat ../../product-team/skills/competitive-teardown/references/analysis-templates.md
```
- SWOT analysis per major competitor
- Positioning map (2x2)
@ -226,7 +226,7 @@ Competitor B,9,6,8,5,8,6,6
Competitor C,5,9,5,7,5,8,9
EOF
python ../../product-team/competitive-teardown/scripts/competitive_matrix_builder.py competitors.csv
python ../../product-team/skills/competitive-teardown/scripts/competitive_matrix_builder.py competitors.csv
```
### Workflow 3: Product Vision Document
@ -250,7 +250,7 @@ python ../../product-team/competitive-teardown/scripts/competitive_matrix_builde
3. **Map the Strategy** - Connect vision to execution:
```bash
# Review strategy frameworks
cat ../../product-team/product-strategist/references/strategy_types.md
cat ../../product-team/skills/product-strategist/references/strategy_types.md
```
- Choose strategic posture (category leader, disruptor, fast follower)
- Define competitive moats (technology, network effects, data, brand)
@ -292,7 +292,7 @@ python ../../product-team/competitive-teardown/scripts/competitive_matrix_builde
2. **Quantify Current Performance** - Baseline analysis:
```bash
# Assess current initiative portfolio
python ../../product-team/product-manager-toolkit/scripts/rice_prioritizer.py current-initiatives.csv
python ../../product-team/skills/product-manager-toolkit/scripts/rice_prioritizer.py current-initiatives.csv
```
- Revenue trajectory and unit economics
- Customer acquisition cost trends
@ -310,7 +310,7 @@ python ../../product-team/competitive-teardown/scripts/competitive_matrix_builde
4. **Score Each Option** - Structured evaluation:
```bash
# Build comparison matrix for pivot options
python ../../product-team/competitive-teardown/scripts/competitive_matrix_builder.py pivot-options.csv
python ../../product-team/skills/competitive-teardown/scripts/competitive_matrix_builder.py pivot-options.csv
```
- Market size and growth potential
- Competitive intensity in new direction
@ -327,7 +327,7 @@ python ../../product-team/competitive-teardown/scripts/competitive_matrix_builde
6. **Set Pivot OKRs** - Define success for the new direction:
```bash
python ../../product-team/product-strategist/scripts/okr_cascade_generator.py pivot
python ../../product-team/skills/product-strategist/scripts/okr_cascade_generator.py pivot
```
**Expected Output:** Pivot analysis document with current state assessment, option evaluation, recommended path, transition plan, and pivot-specific OKRs
@ -345,10 +345,10 @@ Problem Pivot to Workflow,8,6,7,5,6
Technology Pivot to AI-Native,9,4,8,4,7
EOF
python ../../product-team/competitive-teardown/scripts/competitive_matrix_builder.py pivot-options.csv
python ../../product-team/skills/competitive-teardown/scripts/competitive_matrix_builder.py pivot-options.csv
# Generate OKRs for recommended pivot direction
python ../../product-team/product-strategist/scripts/okr_cascade_generator.py growth
python ../../product-team/skills/product-strategist/scripts/okr_cascade_generator.py growth
```
## Integration Examples
@ -367,22 +367,22 @@ echo "================================"
# Competitive landscape
echo ""
echo "1. Competitive Analysis:"
python ../../product-team/competitive-teardown/scripts/competitive_matrix_builder.py annual-competitors.csv
python ../../product-team/skills/competitive-teardown/scripts/competitive_matrix_builder.py annual-competitors.csv
# Strategy reference
echo ""
echo "2. Strategy Frameworks:"
cat ../../product-team/product-strategist/references/strategy_types.md | head -50
cat ../../product-team/skills/product-strategist/references/strategy_types.md | head -50
# Annual OKR cascade
echo ""
echo "3. Annual OKR Cascade:"
python ../../product-team/product-strategist/scripts/okr_cascade_generator.py growth
python ../../product-team/skills/product-strategist/scripts/okr_cascade_generator.py growth
# Initiative prioritization
echo ""
echo "4. Strategic Initiative Prioritization:"
python ../../product-team/product-manager-toolkit/scripts/rice_prioritizer.py annual-initiatives.csv --capacity 180
python ../../product-team/skills/product-manager-toolkit/scripts/rice_prioritizer.py annual-initiatives.csv --capacity 180
```
### Example 2: Monthly Strategy Review
@ -397,17 +397,17 @@ echo "============================================"
# Competitive movements
echo ""
echo "Competitive Updates:"
echo "Review: ../../product-team/competitive-teardown/references/data-collection-guide.md"
echo "Review: ../../product-team/skills/competitive-teardown/references/data-collection-guide.md"
# OKR progress
echo ""
echo "OKR Progress:"
echo "Review: ../../product-team/product-strategist/assets/okr_template.md"
echo "Review: ../../product-team/skills/product-strategist/assets/okr_template.md"
# Initiative status
echo ""
echo "Initiative Portfolio:"
python ../../product-team/product-manager-toolkit/scripts/rice_prioritizer.py current-initiatives.csv
python ../../product-team/skills/product-manager-toolkit/scripts/rice_prioritizer.py current-initiatives.csv
```
### Example 3: Board Preparation
@ -424,17 +424,17 @@ echo "============================="
# Strategic metrics
echo ""
echo "1. Product Strategy Performance:"
python ../../product-team/product-manager-toolkit/scripts/rice_prioritizer.py $QUARTER-delivered.csv
python ../../product-team/skills/product-manager-toolkit/scripts/rice_prioritizer.py $QUARTER-delivered.csv
# Competitive position
echo ""
echo "2. Competitive Positioning:"
python ../../product-team/competitive-teardown/scripts/competitive_matrix_builder.py board-competitors.csv
python ../../product-team/skills/competitive-teardown/scripts/competitive_matrix_builder.py board-competitors.csv
# Next quarter OKRs
echo ""
echo "3. Next Quarter OKR Proposal:"
python ../../product-team/product-strategist/scripts/okr_cascade_generator.py growth
python ../../product-team/skills/product-strategist/scripts/okr_cascade_generator.py growth
```
## Success Metrics
@ -469,14 +469,14 @@ python ../../product-team/product-strategist/scripts/okr_cascade_generator.py gr
- [cs-agile-product-owner](cs-agile-product-owner.md) - Sprint-level planning and backlog management
- [cs-ux-researcher](cs-ux-researcher.md) - User research to validate strategic assumptions
- [cs-ceo-advisor](../c-level/cs-ceo-advisor.md) - Company-level strategic alignment
- Senior PM Skill - Portfolio context (see `../../project-management/senior-pm/`)
- Senior PM Skill - Portfolio context (see `../../project-management/skills/senior-pm/`)
## References
- **Primary Skill:** [../../product-team/product-strategist/SKILL.md](../../product-team/product-strategist/SKILL.md)
- **Competitive Teardown Skill:** [../../product-team/competitive-teardown/SKILL.md](../../product-team/competitive-teardown/SKILL.md)
- **OKR Framework:** [../../product-team/product-strategist/references/okr_framework.md](../../product-team/product-strategist/references/okr_framework.md)
- **Strategy Types:** [../../product-team/product-strategist/references/strategy_types.md](../../product-team/product-strategist/references/strategy_types.md)
- **Primary Skill:** [../../product-team/skills/product-strategist/SKILL.md](../../product-team/skills/product-strategist/SKILL.md)
- **Competitive Teardown Skill:** [../../product-team/skills/competitive-teardown/SKILL.md](../../product-team/skills/competitive-teardown/SKILL.md)
- **OKR Framework:** [../../product-team/skills/product-strategist/references/okr_framework.md](../../product-team/skills/product-strategist/references/okr_framework.md)
- **Strategy Types:** [../../product-team/skills/product-strategist/references/strategy_types.md](../../product-team/skills/product-strategist/references/strategy_types.md)
- **Product Domain Guide:** [../../product-team/CLAUDE.md](../../product-team/CLAUDE.md)
- **Agent Development Guide:** [../CLAUDE.md](../CLAUDE.md)

126
agents/product/cs-ux-researcher.md
View file

@ -19,78 +19,78 @@ The cs-ux-researcher agent ensures that user needs drive product development. It
## Skill Integration
**Primary Skill:** `../../product-team/ux-researcher-designer/`
**Primary Skill:** `../../product-team/skills/ux-researcher-designer/`
### All Orchestrated Skills
| # | Skill | Location | Primary Tool |
|---|-------|----------|-------------|
| 1 | UX Researcher & Designer | `../../product-team/ux-researcher-designer/` | persona_generator.py |
| 2 | Product Manager Toolkit | `../../product-team/product-manager-toolkit/` | customer_interview_analyzer.py |
| 3 | UI Design System | `../../product-team/ui-design-system/` | design_token_generator.py |
| 1 | UX Researcher & Designer | `../../product-team/skills/ux-researcher-designer/` | persona_generator.py |
| 2 | Product Manager Toolkit | `../../product-team/skills/product-manager-toolkit/` | customer_interview_analyzer.py |
| 3 | UI Design System | `../../product-team/skills/ui-design-system/` | design_token_generator.py |
### Python Tools
1. **Persona Generator**
- **Purpose:** Create data-driven user personas from research inputs including demographics, goals, pain points, and behavioral patterns
- **Path:** `../../product-team/ux-researcher-designer/scripts/persona_generator.py`
- **Usage:** `python ../../product-team/ux-researcher-designer/scripts/persona_generator.py research-data.json`
- **Path:** `../../product-team/skills/ux-researcher-designer/scripts/persona_generator.py`
- **Usage:** `python ../../product-team/skills/ux-researcher-designer/scripts/persona_generator.py research-data.json`
- **Features:** Multiple persona generation, behavioral segmentation, needs hierarchy mapping, empathy map creation
- **Use Cases:** Persona development, user segmentation, design alignment, stakeholder communication
2. **Customer Interview Analyzer**
- **Purpose:** NLP-based analysis of interview transcripts to extract pain points, feature requests, themes, and sentiment
- **Path:** `../../product-team/product-manager-toolkit/scripts/customer_interview_analyzer.py`
- **Usage:** `python ../../product-team/product-manager-toolkit/scripts/customer_interview_analyzer.py interview.txt`
- **Path:** `../../product-team/skills/product-manager-toolkit/scripts/customer_interview_analyzer.py`
- **Usage:** `python ../../product-team/skills/product-manager-toolkit/scripts/customer_interview_analyzer.py interview.txt`
- **Features:** Pain point extraction with severity scoring, feature request identification, jobs-to-be-done patterns, theme clustering, key quote extraction
- **Use Cases:** Interview synthesis, discovery validation, problem prioritization, insight aggregation
3. **Design Token Generator**
- **Purpose:** Generate design tokens for consistent UI implementation across platforms
- **Path:** `../../product-team/ui-design-system/scripts/design_token_generator.py`
- **Usage:** `python ../../product-team/ui-design-system/scripts/design_token_generator.py theme.json`
- **Path:** `../../product-team/skills/ui-design-system/scripts/design_token_generator.py`
- **Usage:** `python ../../product-team/skills/ui-design-system/scripts/design_token_generator.py theme.json`
- **Use Cases:** Research-informed design system updates, accessibility token adjustments
### Knowledge Bases
1. **Persona Methodology**
- **Location:** `../../product-team/ux-researcher-designer/references/persona-methodology.md`
- **Location:** `../../product-team/skills/ux-researcher-designer/references/persona-methodology.md`
- **Content:** Research-backed persona creation methodology, data collection strategies, validation approaches
- **Use Case:** Methodological guidance for persona projects
2. **Example Personas**
- **Location:** `../../product-team/ux-researcher-designer/references/example-personas.md`
- **Location:** `../../product-team/skills/ux-researcher-designer/references/example-personas.md`
- **Content:** Sample persona documents with demographics, goals, pain points, behaviors, scenarios
- **Use Case:** Persona format reference, team training
3. **Journey Mapping Guide**
- **Location:** `../../product-team/ux-researcher-designer/references/journey-mapping-guide.md`
- **Location:** `../../product-team/skills/ux-researcher-designer/references/journey-mapping-guide.md`
- **Content:** Customer journey mapping methodology, touchpoint analysis, emotion mapping, opportunity identification
- **Use Case:** Journey map creation, experience design, service design
4. **Usability Testing Frameworks**
- **Location:** `../../product-team/ux-researcher-designer/references/usability-testing-frameworks.md`
- **Location:** `../../product-team/skills/ux-researcher-designer/references/usability-testing-frameworks.md`
- **Content:** Test planning, task design, analysis methods, severity ratings, reporting formats
- **Use Case:** Usability study design, prototype validation, UX evaluation
5. **Component Architecture**
- **Location:** `../../product-team/ui-design-system/references/component-architecture.md`
- **Location:** `../../product-team/skills/ui-design-system/references/component-architecture.md`
- **Content:** Component hierarchy, atomic design patterns, composition strategies
- **Use Case:** Research-to-design translation, component recommendations
6. **Developer Handoff**
- **Location:** `../../product-team/ui-design-system/references/developer-handoff.md`
- **Location:** `../../product-team/skills/ui-design-system/references/developer-handoff.md`
- **Content:** Design-to-dev handoff process, specification formats, asset delivery
- **Use Case:** Translating research findings into implementation specs
### Templates
1. **Research Plan Template**
- **Location:** `../../product-team/ux-researcher-designer/assets/research_plan_template.md`
- **Location:** `../../product-team/skills/ux-researcher-designer/assets/research_plan_template.md`
- **Use Case:** Structuring research studies with methodology, participants, and analysis plan
2. **Design System Documentation Template**
- **Location:** `../../product-team/ui-design-system/assets/design_system_doc_template.md`
- **Location:** `../../product-team/skills/ui-design-system/assets/design_system_doc_template.md`
- **Use Case:** Documenting research-informed design system decisions
## Workflows
@ -109,7 +109,7 @@ The cs-ux-researcher agent ensures that user needs drive product development. It
2. **Select Methodology** - Choose the right approach:
```bash
# Review usability testing frameworks for method selection
cat ../../product-team/ux-researcher-designer/references/usability-testing-frameworks.md
cat ../../product-team/skills/ux-researcher-designer/references/usability-testing-frameworks.md
```
- **Exploratory** (interviews, contextual inquiry): When learning about problem space
- **Evaluative** (usability testing, A/B tests): When validating solutions
@ -125,7 +125,7 @@ The cs-ux-researcher agent ensures that user needs drive product development. It
4. **Create Study Materials** - Prepare research instruments:
```bash
# Use the research plan template
cat ../../product-team/ux-researcher-designer/assets/research_plan_template.md
cat ../../product-team/skills/ux-researcher-designer/assets/research_plan_template.md
```
- Interview guide or test script
- Task scenarios (for usability tests)
@ -145,13 +145,13 @@ The cs-ux-researcher agent ensures that user needs drive product development. It
**Example:**
```bash
# Create research plan from template
cp ../../product-team/ux-researcher-designer/assets/research_plan_template.md onboarding-research-plan.md
cp ../../product-team/skills/ux-researcher-designer/assets/research_plan_template.md onboarding-research-plan.md
# Review methodology options
cat ../../product-team/ux-researcher-designer/references/usability-testing-frameworks.md
cat ../../product-team/skills/ux-researcher-designer/references/usability-testing-frameworks.md
# Review persona methodology for participant criteria
cat ../../product-team/ux-researcher-designer/references/persona-methodology.md
cat ../../product-team/skills/ux-researcher-designer/references/persona-methodology.md
```
### Workflow 2: Persona Generation
@ -169,9 +169,9 @@ cat ../../product-team/ux-researcher-designer/references/persona-methodology.md
2. **Analyze Interview Data** - Extract structured insights:
```bash
# Analyze each interview transcript
python ../../product-team/product-manager-toolkit/scripts/customer_interview_analyzer.py interview-001.txt > insights-001.json
python ../../product-team/product-manager-toolkit/scripts/customer_interview_analyzer.py interview-002.txt > insights-002.json
python ../../product-team/product-manager-toolkit/scripts/customer_interview_analyzer.py interview-003.txt > insights-003.json
python ../../product-team/skills/product-manager-toolkit/scripts/customer_interview_analyzer.py interview-001.txt > insights-001.json
python ../../product-team/skills/product-manager-toolkit/scripts/customer_interview_analyzer.py interview-002.txt > insights-002.json
python ../../product-team/skills/product-manager-toolkit/scripts/customer_interview_analyzer.py interview-003.txt > insights-003.json
```
3. **Identify Behavioral Segments** - Cluster users by:
@ -184,7 +184,7 @@ cat ../../product-team/ux-researcher-designer/references/persona-methodology.md
4. **Generate Personas** - Create data-backed personas:
```bash
# Generate personas from aggregated research
python ../../product-team/ux-researcher-designer/scripts/persona_generator.py research-data.json
python ../../product-team/skills/ux-researcher-designer/scripts/persona_generator.py research-data.json
```
5. **Validate Personas** - Ensure accuracy:
@ -196,7 +196,7 @@ cat ../../product-team/ux-researcher-designer/references/persona-methodology.md
6. **Socialize Personas** - Make personas actionable:
```bash
# Review example personas for format guidance
cat ../../product-team/ux-researcher-designer/references/example-personas.md
cat ../../product-team/skills/ux-researcher-designer/references/example-personas.md
```
- Create one-page persona cards for team walls/wikis
- Present to product, engineering, and design teams
@ -216,18 +216,18 @@ echo "==========================="
# Step 1: Analyze interviews
for f in interviews/*.txt; do
base=$(basename "$f" .txt)
python ../../product-team/product-manager-toolkit/scripts/customer_interview_analyzer.py "$f" json > "insights-$base.json"
python ../../product-team/skills/product-manager-toolkit/scripts/customer_interview_analyzer.py "$f" json > "insights-$base.json"
echo "Analyzed: $f"
done
# Step 2: Review persona methodology
cat ../../product-team/ux-researcher-designer/references/persona-methodology.md
cat ../../product-team/skills/ux-researcher-designer/references/persona-methodology.md
# Step 3: Generate personas
python ../../product-team/ux-researcher-designer/scripts/persona_generator.py research-data.json
python ../../product-team/skills/ux-researcher-designer/scripts/persona_generator.py research-data.json
# Step 4: Review example format
cat ../../product-team/ux-researcher-designer/references/example-personas.md
cat ../../product-team/skills/ux-researcher-designer/references/example-personas.md
```
### Workflow 3: Journey Mapping
@ -243,7 +243,7 @@ cat ../../product-team/ux-researcher-designer/references/example-personas.md
2. **Review Journey Mapping Methodology** - Understand the framework:
```bash
cat ../../product-team/ux-researcher-designer/references/journey-mapping-guide.md
cat ../../product-team/skills/ux-researcher-designer/references/journey-mapping-guide.md
```
3. **Map Journey Stages** - Identify key phases:
@ -278,7 +278,7 @@ cat ../../product-team/ux-researcher-designer/references/example-personas.md
Self-service help in context,600,2,0.8,2
Upgrade prompt optimization,400,3,0.6,2
EOF
python ../../product-team/product-manager-toolkit/scripts/rice_prioritizer.py journey-opportunities.csv
python ../../product-team/skills/product-manager-toolkit/scripts/rice_prioritizer.py journey-opportunities.csv
```
**Expected Output:** Visual journey map with stages, touchpoints, emotions, pain points, and prioritized improvement opportunities
@ -292,14 +292,14 @@ echo "Journey Mapping - Onboarding Flow"
echo "=================================="
# Review journey mapping methodology
cat ../../product-team/ux-researcher-designer/references/journey-mapping-guide.md
cat ../../product-team/skills/ux-researcher-designer/references/journey-mapping-guide.md
# Analyze relevant interview transcripts for journey insights
python ../../product-team/product-manager-toolkit/scripts/customer_interview_analyzer.py onboarding-interview-01.txt
python ../../product-team/product-manager-toolkit/scripts/customer_interview_analyzer.py onboarding-interview-02.txt
python ../../product-team/skills/product-manager-toolkit/scripts/customer_interview_analyzer.py onboarding-interview-01.txt
python ../../product-team/skills/product-manager-toolkit/scripts/customer_interview_analyzer.py onboarding-interview-02.txt
# Prioritize improvement opportunities
python ../../product-team/product-manager-toolkit/scripts/rice_prioritizer.py journey-opportunities.csv
python ../../product-team/skills/product-manager-toolkit/scripts/rice_prioritizer.py journey-opportunities.csv
```
### Workflow 4: Usability Test Analysis
@ -310,7 +310,7 @@ python ../../product-team/product-manager-toolkit/scripts/rice_prioritizer.py jo
1. **Plan the Test** - Design the study:
```bash
# Review usability testing frameworks
cat ../../product-team/ux-researcher-designer/references/usability-testing-frameworks.md
cat ../../product-team/skills/ux-researcher-designer/references/usability-testing-frameworks.md
```
- Define test objectives (what decisions will this inform)
- Select test type (moderated/unmoderated, remote/in-person)
@ -324,7 +324,7 @@ python ../../product-team/product-manager-toolkit/scripts/rice_prioritizer.py jo
- Note-taking template for observers
- Use research plan template for documentation:
```bash
cat ../../product-team/ux-researcher-designer/assets/research_plan_template.md
cat ../../product-team/skills/ux-researcher-designer/assets/research_plan_template.md
```
3. **Conduct Sessions** - Run 5-8 sessions:
@ -347,8 +347,8 @@ python ../../product-team/product-manager-toolkit/scripts/rice_prioritizer.py jo
5. **Analyze Verbal Feedback** - Extract qualitative insights:
```bash
# Analyze session transcripts for themes
python ../../product-team/product-manager-toolkit/scripts/customer_interview_analyzer.py usability-session-01.txt
python ../../product-team/product-manager-toolkit/scripts/customer_interview_analyzer.py usability-session-02.txt
python ../../product-team/skills/product-manager-toolkit/scripts/customer_interview_analyzer.py usability-session-01.txt
python ../../product-team/skills/product-manager-toolkit/scripts/customer_interview_analyzer.py usability-session-02.txt
```
6. **Create Report and Recommendations** - Deliver findings:
@ -362,7 +362,7 @@ python ../../product-team/product-manager-toolkit/scripts/rice_prioritizer.py jo
- Review findings with design team
- Map issues to components in design system:
```bash
cat ../../product-team/ui-design-system/references/component-architecture.md
cat ../../product-team/skills/ui-design-system/references/component-architecture.md
```
- Create Jira tickets for each issue
- Plan re-test for critical issues after fixes
@ -378,17 +378,17 @@ echo "Usability Test Analysis"
echo "======================="
# Review frameworks
cat ../../product-team/ux-researcher-designer/references/usability-testing-frameworks.md
cat ../../product-team/skills/ux-researcher-designer/references/usability-testing-frameworks.md
# Analyze each session transcript
for i in 1 2 3 4 5; do
echo "Session $i Analysis:"
python ../../product-team/product-manager-toolkit/scripts/customer_interview_analyzer.py "usability-session-0$i.txt"
python ../../product-team/skills/product-manager-toolkit/scripts/customer_interview_analyzer.py "usability-session-0$i.txt"
echo ""
done
# Review component architecture for design recommendations
cat ../../product-team/ui-design-system/references/component-architecture.md
cat ../../product-team/skills/ui-design-system/references/component-architecture.md
```
## Integration Examples
@ -411,7 +411,7 @@ echo "-------------------------------------"
for f in discovery-interviews/*.txt; do
base=$(basename "$f" .txt)
echo "Analyzing: $base"
python ../../product-team/product-manager-toolkit/scripts/customer_interview_analyzer.py "$f" json > "insights/$base.json"
python ../../product-team/skills/product-manager-toolkit/scripts/customer_interview_analyzer.py "$f" json > "insights/$base.json"
done
# Week 2: Synthesis
@ -420,10 +420,10 @@ echo "Week 2: Generate Personas & Journey Map"
echo "----------------------------------------"
# Generate personas from aggregated data
python ../../product-team/ux-researcher-designer/scripts/persona_generator.py aggregated-research.json
python ../../product-team/skills/ux-researcher-designer/scripts/persona_generator.py aggregated-research.json
# Reference journey mapping guide
echo "Journey mapping guide: ../../product-team/ux-researcher-designer/references/journey-mapping-guide.md"
echo "Journey mapping guide: ../../product-team/skills/ux-researcher-designer/references/journey-mapping-guide.md"
```
### Example 2: Research Repository Update
@ -439,15 +439,15 @@ echo "================================================"
echo ""
echo "New Interview Analysis:"
for f in new-interviews/*.txt; do
python ../../product-team/product-manager-toolkit/scripts/customer_interview_analyzer.py "$f"
python ../../product-team/skills/product-manager-toolkit/scripts/customer_interview_analyzer.py "$f"
echo "---"
done
# Review and refresh personas
echo ""
echo "Persona Review:"
echo "Current personas: ../../product-team/ux-researcher-designer/references/example-personas.md"
echo "Methodology: ../../product-team/ux-researcher-designer/references/persona-methodology.md"
echo "Current personas: ../../product-team/skills/ux-researcher-designer/references/example-personas.md"
echo "Methodology: ../../product-team/skills/ux-researcher-designer/references/persona-methodology.md"
```
### Example 3: Design Handoff with Research Context
@ -462,22 +462,22 @@ echo "========================"
# Persona context
echo ""
echo "1. Active Personas:"
cat ../../product-team/ux-researcher-designer/references/example-personas.md | head -30
cat ../../product-team/skills/ux-researcher-designer/references/example-personas.md | head -30
# Journey context
echo ""
echo "2. Journey Map Reference:"
echo "See: ../../product-team/ux-researcher-designer/references/journey-mapping-guide.md"
echo "See: ../../product-team/skills/ux-researcher-designer/references/journey-mapping-guide.md"
# Design system alignment
echo ""
echo "3. Component Architecture:"
echo "See: ../../product-team/ui-design-system/references/component-architecture.md"
echo "See: ../../product-team/skills/ui-design-system/references/component-architecture.md"
# Developer handoff process
echo ""
echo "4. Handoff Process:"
echo "See: ../../product-team/ui-design-system/references/developer-handoff.md"
echo "See: ../../product-team/skills/ui-design-system/references/developer-handoff.md"
```
## Success Metrics
@ -511,16 +511,16 @@ echo "See: ../../product-team/ui-design-system/references/developer-handoff.md"
- [cs-product-manager](cs-product-manager.md) - Product management lifecycle, interview analysis, PRD development
- [cs-agile-product-owner](cs-agile-product-owner.md) - Translating research findings into user stories
- [cs-product-strategist](cs-product-strategist.md) - Strategic research to validate product vision and positioning
- UI Design System - Design handoff and component recommendations (see `../../product-team/ui-design-system/`)
- UI Design System - Design handoff and component recommendations (see `../../product-team/skills/ui-design-system/`)
## References
- **Primary Skill:** [../../product-team/ux-researcher-designer/SKILL.md](../../product-team/ux-researcher-designer/SKILL.md)
- **Interview Analyzer:** [../../product-team/product-manager-toolkit/SKILL.md](../../product-team/product-manager-toolkit/SKILL.md)
- **Persona Methodology:** [../../product-team/ux-researcher-designer/references/persona-methodology.md](../../product-team/ux-researcher-designer/references/persona-methodology.md)
- **Journey Mapping Guide:** [../../product-team/ux-researcher-designer/references/journey-mapping-guide.md](../../product-team/ux-researcher-designer/references/journey-mapping-guide.md)
- **Usability Testing:** [../../product-team/ux-researcher-designer/references/usability-testing-frameworks.md](../../product-team/ux-researcher-designer/references/usability-testing-frameworks.md)
- **Design System:** [../../product-team/ui-design-system/SKILL.md](../../product-team/ui-design-system/SKILL.md)
- **Primary Skill:** [../../product-team/skills/ux-researcher-designer/SKILL.md](../../product-team/skills/ux-researcher-designer/SKILL.md)
- **Interview Analyzer:** [../../product-team/skills/product-manager-toolkit/SKILL.md](../../product-team/skills/product-manager-toolkit/SKILL.md)
- **Persona Methodology:** [../../product-team/skills/ux-researcher-designer/references/persona-methodology.md](../../product-team/skills/ux-researcher-designer/references/persona-methodology.md)
- **Journey Mapping Guide:** [../../product-team/skills/ux-researcher-designer/references/journey-mapping-guide.md](../../product-team/skills/ux-researcher-designer/references/journey-mapping-guide.md)
- **Usability Testing:** [../../product-team/skills/ux-researcher-designer/references/usability-testing-frameworks.md](../../product-team/skills/ux-researcher-designer/references/usability-testing-frameworks.md)
- **Design System:** [../../product-team/skills/ui-design-system/SKILL.md](../../product-team/skills/ui-design-system/SKILL.md)
- **Product Domain Guide:** [../../product-team/CLAUDE.md](../../product-team/CLAUDE.md)
- **Agent Development Guide:** [../CLAUDE.md](../CLAUDE.md)

158
agents/project-management/cs-project-manager.md
View file

@ -21,103 +21,103 @@ The cs-project-manager agent bridges the gap between project execution and strat
### Senior PM
**Skill Location:** `../../project-management/senior-pm/`
**Skill Location:** `../../project-management/skills/senior-pm/`
**Python Tools:**
1. **Project Health Dashboard**
- **Purpose:** Generate portfolio-level health dashboard with RAG status across all active projects
- **Path:** `../../project-management/senior-pm/scripts/project_health_dashboard.py`
- **Usage:** `python ../../project-management/senior-pm/scripts/project_health_dashboard.py sample_project_data.json`
- **Path:** `../../project-management/skills/senior-pm/scripts/project_health_dashboard.py`
- **Usage:** `python ../../project-management/skills/senior-pm/scripts/project_health_dashboard.py sample_project_data.json`
- **Features:** Schedule variance, budget tracking, risk exposure, milestone status, RAG indicators
2. **Risk Matrix Analyzer**
- **Purpose:** Quantitative risk analysis with probability-impact matrices and Expected Monetary Value (EMV)
- **Path:** `../../project-management/senior-pm/scripts/risk_matrix_analyzer.py`
- **Usage:** `python ../../project-management/senior-pm/scripts/risk_matrix_analyzer.py risks.json`
- **Path:** `../../project-management/skills/senior-pm/scripts/risk_matrix_analyzer.py`
- **Usage:** `python ../../project-management/skills/senior-pm/scripts/risk_matrix_analyzer.py risks.json`
- **Features:** Risk scoring, heat map generation, mitigation tracking, EMV calculation
3. **Resource Capacity Planner**
- **Purpose:** Team resource allocation and capacity forecasting across sprints and projects
- **Path:** `../../project-management/senior-pm/scripts/resource_capacity_planner.py`
- **Usage:** `python ../../project-management/senior-pm/scripts/resource_capacity_planner.py team_data.json`
- **Path:** `../../project-management/skills/senior-pm/scripts/resource_capacity_planner.py`
- **Usage:** `python ../../project-management/skills/senior-pm/scripts/resource_capacity_planner.py team_data.json`
- **Features:** Utilization analysis, over-allocation detection, capacity forecasting, cross-project balancing
**Knowledge Bases:**
- `../../project-management/senior-pm/references/portfolio-prioritization-models.md` -- WSJF, MoSCoW, Cost of Delay, portfolio scoring frameworks
- `../../project-management/senior-pm/references/risk-management-framework.md` -- Risk identification, qualitative/quantitative analysis, response strategies
- `../../project-management/senior-pm/references/portfolio-kpis.md` -- KPI definitions, tracking cadences, executive reporting metrics
- `../../project-management/skills/senior-pm/references/portfolio-prioritization-models.md` -- WSJF, MoSCoW, Cost of Delay, portfolio scoring frameworks
- `../../project-management/skills/senior-pm/references/risk-management-framework.md` -- Risk identification, qualitative/quantitative analysis, response strategies
- `../../project-management/skills/senior-pm/references/portfolio-kpis.md` -- KPI definitions, tracking cadences, executive reporting metrics
**Templates:**
- `../../project-management/senior-pm/assets/executive_report_template.md` -- Executive status report with RAG, risks, decisions needed
- `../../project-management/senior-pm/assets/project_charter_template.md` -- Project charter with scope, objectives, constraints, stakeholders
- `../../project-management/senior-pm/assets/raci_matrix_template.md` -- Responsibility assignment matrix for cross-functional teams
- `../../project-management/skills/senior-pm/assets/executive_report_template.md` -- Executive status report with RAG, risks, decisions needed
- `../../project-management/skills/senior-pm/assets/project_charter_template.md` -- Project charter with scope, objectives, constraints, stakeholders
- `../../project-management/skills/senior-pm/assets/raci_matrix_template.md` -- Responsibility assignment matrix for cross-functional teams
### Scrum Master
**Skill Location:** `../../project-management/scrum-master/`
**Skill Location:** `../../project-management/skills/scrum-master/`
**Python Tools:**
1. **Sprint Health Scorer**
- **Purpose:** Quantitative sprint health assessment across scope, velocity, quality, and team morale
- **Path:** `../../project-management/scrum-master/scripts/sprint_health_scorer.py`
- **Usage:** `python ../../project-management/scrum-master/scripts/sprint_health_scorer.py sample_sprint_data.json`
- **Path:** `../../project-management/skills/scrum-master/scripts/sprint_health_scorer.py`
- **Usage:** `python ../../project-management/skills/scrum-master/scripts/sprint_health_scorer.py sample_sprint_data.json`
- **Features:** Multi-dimensional scoring (0-100), trend analysis, health indicators, actionable recommendations
2. **Velocity Analyzer**
- **Purpose:** Historical velocity analysis with forecasting and confidence intervals
- **Path:** `../../project-management/scrum-master/scripts/velocity_analyzer.py`
- **Usage:** `python ../../project-management/scrum-master/scripts/velocity_analyzer.py sprint_history.json`
- **Path:** `../../project-management/skills/scrum-master/scripts/velocity_analyzer.py`
- **Usage:** `python ../../project-management/skills/scrum-master/scripts/velocity_analyzer.py sprint_history.json`
- **Features:** Rolling averages, standard deviation, sprint-over-sprint trends, capacity prediction
3. **Retrospective Analyzer**
- **Purpose:** Structured retrospective analysis with action item tracking and theme extraction
- **Path:** `../../project-management/scrum-master/scripts/retrospective_analyzer.py`
- **Usage:** `python ../../project-management/scrum-master/scripts/retrospective_analyzer.py retro_notes.json`
- **Path:** `../../project-management/skills/scrum-master/scripts/retrospective_analyzer.py`
- **Usage:** `python ../../project-management/skills/scrum-master/scripts/retrospective_analyzer.py retro_notes.json`
- **Features:** Theme clustering, sentiment analysis, action item extraction, trend tracking across sprints
**Knowledge Bases:**
- `../../project-management/scrum-master/references/retro-formats.md` -- Start/Stop/Continue, 4Ls, Sailboat, Mad/Sad/Glad, Starfish formats
- `../../project-management/scrum-master/references/team-dynamics-framework.md` -- Tuckman stages, psychological safety, conflict resolution
- `../../project-management/scrum-master/references/velocity-forecasting-guide.md` -- Monte Carlo simulation, confidence ranges, capacity planning
- `../../project-management/skills/scrum-master/references/retro-formats.md` -- Start/Stop/Continue, 4Ls, Sailboat, Mad/Sad/Glad, Starfish formats
- `../../project-management/skills/scrum-master/references/team-dynamics-framework.md` -- Tuckman stages, psychological safety, conflict resolution
- `../../project-management/skills/scrum-master/references/velocity-forecasting-guide.md` -- Monte Carlo simulation, confidence ranges, capacity planning
**Templates:**
- `../../project-management/scrum-master/assets/sprint_report_template.md` -- Sprint review report with burndown, velocity, demo notes
- `../../project-management/scrum-master/assets/team_health_check_template.md` -- Spotify-style team health check across 8 dimensions
- `../../project-management/skills/scrum-master/assets/sprint_report_template.md` -- Sprint review report with burndown, velocity, demo notes
- `../../project-management/skills/scrum-master/assets/team_health_check_template.md` -- Spotify-style team health check across 8 dimensions
### Jira Expert
**Skill Location:** `../../project-management/jira-expert/`
**Skill Location:** `../../project-management/skills/jira-expert/`
**Knowledge Bases:**
- `../../project-management/jira-expert/references/jql-examples.md` -- JQL query patterns for backlog grooming, sprint reporting, SLA tracking
- `../../project-management/jira-expert/references/automation-examples.md` -- Jira automation rule templates for common workflows
- `../../project-management/jira-expert/references/AUTOMATION.md` -- Comprehensive automation guide with triggers, conditions, actions
- `../../project-management/jira-expert/references/WORKFLOWS.md` -- Workflow design patterns, transition rules, validators, post-functions
- `../../project-management/skills/jira-expert/references/jql-examples.md` -- JQL query patterns for backlog grooming, sprint reporting, SLA tracking
- `../../project-management/skills/jira-expert/references/automation-examples.md` -- Jira automation rule templates for common workflows
- `../../project-management/skills/jira-expert/references/AUTOMATION.md` -- Comprehensive automation guide with triggers, conditions, actions
- `../../project-management/skills/jira-expert/references/WORKFLOWS.md` -- Workflow design patterns, transition rules, validators, post-functions
### Confluence Expert
**Skill Location:** `../../project-management/confluence-expert/`
**Skill Location:** `../../project-management/skills/confluence-expert/`
**Knowledge Bases:**
- `../../project-management/confluence-expert/references/templates.md` -- Page templates for sprint plans, meeting notes, decision logs, architecture docs
- `../../project-management/skills/confluence-expert/references/templates.md` -- Page templates for sprint plans, meeting notes, decision logs, architecture docs
### Atlassian Admin
**Skill Location:** `../../project-management/atlassian-admin/`
**Skill Location:** `../../project-management/skills/atlassian-admin/`
Covers user provisioning, permission schemes, project configuration, and integration setup. No scripts or references yet -- relies on SKILL.md workflows.
### Atlassian Templates
**Skill Location:** `../../project-management/atlassian-templates/`
**Skill Location:** `../../project-management/skills/atlassian-templates/`
Covers blueprint creation, custom page layouts, and reusable Confluence/Jira components. No scripts or references yet -- relies on SKILL.md workflows.
@ -131,37 +131,37 @@ Covers blueprint creation, custom page layouts, and reusable Confluence/Jira com
1. **Analyze Velocity History** - Review past sprint performance to set realistic capacity:
```bash
python ../../project-management/scrum-master/scripts/velocity_analyzer.py sprint_history.json
python ../../project-management/skills/scrum-master/scripts/velocity_analyzer.py sprint_history.json
```
- Review rolling average velocity and standard deviation
- Identify trends (accelerating, decelerating, stable)
- Set sprint capacity at 80% of average velocity (buffer for unknowns)
2. **Query Backlog via JQL** - Use jira-expert JQL patterns to pull prioritized candidates:
- Reference: `../../project-management/jira-expert/references/jql-examples.md`
- Reference: `../../project-management/skills/jira-expert/references/jql-examples.md`
- Filter by priority, story points estimated, team assignment
- Identify blocked items, external dependencies, carry-overs from previous sprint
3. **Check Resource Availability** - Verify team capacity for the sprint window:
```bash
python ../../project-management/senior-pm/scripts/resource_capacity_planner.py team_data.json
python ../../project-management/skills/senior-pm/scripts/resource_capacity_planner.py team_data.json
```
- Account for PTO, holidays, shared resources
- Flag over-allocated team members
- Adjust sprint capacity based on actual availability
4. **Select Sprint Backlog** - Commit items within capacity:
- Apply WSJF or priority-based selection (ref: `../../project-management/senior-pm/references/portfolio-prioritization-models.md`)
- Apply WSJF or priority-based selection (ref: `../../project-management/skills/senior-pm/references/portfolio-prioritization-models.md`)
- Ensure sprint goal alignment -- every item should contribute to 1-2 goals
- Include 10-15% capacity for bug fixes and operational work
5. **Document Sprint Plan** - Create Confluence sprint plan page:
- Use template from `../../project-management/confluence-expert/references/templates.md`
- Use template from `../../project-management/skills/confluence-expert/references/templates.md`
- Include sprint goal, committed stories, capacity breakdown, risks
- Link to Jira sprint board for live tracking
6. **Set Up Sprint Tracking** - Configure dashboards and automation:
- Create burndown/burnup dashboard (ref: `../../project-management/jira-expert/references/AUTOMATION.md`)
- Create burndown/burnup dashboard (ref: `../../project-management/skills/jira-expert/references/AUTOMATION.md`)
- Set up daily standup reminder automation
- Configure sprint scope change alerts
@ -172,8 +172,8 @@ Covers blueprint creation, custom page layouts, and reusable Confluence/Jira com
**Example:**
```bash
# Full sprint planning workflow
python ../../project-management/scrum-master/scripts/velocity_analyzer.py sprint_history.json > velocity_report.txt
python ../../project-management/senior-pm/scripts/resource_capacity_planner.py team_data.json > capacity_report.txt
python ../../project-management/skills/scrum-master/scripts/velocity_analyzer.py sprint_history.json > velocity_report.txt
python ../../project-management/skills/senior-pm/scripts/resource_capacity_planner.py team_data.json > capacity_report.txt
cat velocity_report.txt
cat capacity_report.txt
# Use velocity average and capacity data to commit sprint items
@ -193,7 +193,7 @@ cat capacity_report.txt
2. **Generate Health Dashboard** - Run project health analysis:
```bash
python ../../project-management/senior-pm/scripts/project_health_dashboard.py portfolio_data.json
python ../../project-management/skills/senior-pm/scripts/project_health_dashboard.py portfolio_data.json
```
- Review per-project RAG status (Red/Amber/Green)
- Identify projects requiring intervention
@ -201,7 +201,7 @@ cat capacity_report.txt
3. **Analyze Risk Exposure** - Quantify portfolio-level risk:
```bash
python ../../project-management/senior-pm/scripts/risk_matrix_analyzer.py portfolio_risks.json
python ../../project-management/skills/senior-pm/scripts/risk_matrix_analyzer.py portfolio_risks.json
```
- Calculate EMV for each risk
- Identify top-10 risks by exposure
@ -210,20 +210,20 @@ cat capacity_report.txt
4. **Review Resource Utilization** - Check cross-project allocation:
```bash
python ../../project-management/senior-pm/scripts/resource_capacity_planner.py all_teams.json
python ../../project-management/skills/senior-pm/scripts/resource_capacity_planner.py all_teams.json
```
- Identify over-allocated individuals (>100% utilization)
- Find under-utilized capacity for rebalancing
- Forecast resource needs for next quarter
5. **Prepare Executive Report** - Assemble findings into report:
- Use template: `../../project-management/senior-pm/assets/executive_report_template.md`
- Use template: `../../project-management/skills/senior-pm/assets/executive_report_template.md`
- Include RAG summary, risk heatmap, resource utilization chart
- Highlight decisions needed from leadership
- Provide recommendations with supporting data
6. **Publish to Confluence** - Create executive dashboard page:
- Reference KPI definitions from `../../project-management/senior-pm/references/portfolio-kpis.md`
- Reference KPI definitions from `../../project-management/skills/senior-pm/references/portfolio-kpis.md`
- Embed Jira macros for live data
- Set up weekly refresh cadence
@ -234,9 +234,9 @@ cat capacity_report.txt
**Example:**
```bash
# Portfolio health review automation
python ../../project-management/senior-pm/scripts/project_health_dashboard.py portfolio_data.json > health_dashboard.txt
python ../../project-management/senior-pm/scripts/risk_matrix_analyzer.py portfolio_risks.json > risk_report.txt
python ../../project-management/senior-pm/scripts/resource_capacity_planner.py all_teams.json > resource_report.txt
python ../../project-management/skills/senior-pm/scripts/project_health_dashboard.py portfolio_data.json > health_dashboard.txt
python ../../project-management/skills/senior-pm/scripts/risk_matrix_analyzer.py portfolio_risks.json > risk_report.txt
python ../../project-management/skills/senior-pm/scripts/resource_capacity_planner.py all_teams.json > resource_report.txt
cat health_dashboard.txt
cat risk_report.txt
cat resource_report.txt
@ -250,14 +250,14 @@ cat resource_report.txt
1. **Gather Sprint Metrics** - Collect quantitative data before the retro:
```bash
python ../../project-management/scrum-master/scripts/sprint_health_scorer.py sprint_data.json
python ../../project-management/skills/scrum-master/scripts/sprint_health_scorer.py sprint_data.json
```
- Review sprint health score (0-100)
- Identify scoring dimensions that dropped (scope, velocity, quality, morale)
- Compare against previous sprint scores for trend analysis
2. **Select Retro Format** - Choose format based on team needs:
- Reference: `../../project-management/scrum-master/references/retro-formats.md`
- Reference: `../../project-management/skills/scrum-master/references/retro-formats.md`
- **Start/Stop/Continue**: General-purpose, good for new teams
- **4Ls (Liked/Learned/Lacked/Longed For)**: Focuses on learning and growth
- **Sailboat**: Visual metaphor for anchors (blockers) and wind (accelerators)
@ -268,11 +268,11 @@ cat resource_report.txt
- Present sprint metrics as context (not judgment)
- Time-box each section (5 min brainstorm, 10 min discuss, 5 min vote)
- Use dot voting to prioritize discussion topics
- Reference team dynamics from `../../project-management/scrum-master/references/team-dynamics-framework.md`
- Reference team dynamics from `../../project-management/skills/scrum-master/references/team-dynamics-framework.md`
4. **Analyze Retro Output** - Extract structured insights:
```bash
python ../../project-management/scrum-master/scripts/retrospective_analyzer.py retro_notes.json
python ../../project-management/skills/scrum-master/scripts/retrospective_analyzer.py retro_notes.json
```
- Identify recurring themes across sprints
- Cluster related items into improvement areas
@ -285,7 +285,7 @@ cat resource_report.txt
- Add action items to next sprint backlog
6. **Document in Confluence** - Publish retro summary:
- Use sprint report template: `../../project-management/scrum-master/assets/sprint_report_template.md`
- Use sprint report template: `../../project-management/skills/scrum-master/assets/sprint_report_template.md`
- Include sprint health score, retro themes, action items, metrics trends
- Link to previous retro pages for longitudinal tracking
@ -301,11 +301,11 @@ cat resource_report.txt
**Example:**
```bash
# Pre-retro data collection
python ../../project-management/scrum-master/scripts/sprint_health_scorer.py sprint_data.json > health_score.txt
python ../../project-management/scrum-master/scripts/velocity_analyzer.py sprint_history.json > velocity_trend.txt
python ../../project-management/skills/scrum-master/scripts/sprint_health_scorer.py sprint_data.json > health_score.txt
python ../../project-management/skills/scrum-master/scripts/velocity_analyzer.py sprint_history.json > velocity_trend.txt
cat health_score.txt
# Use health score insights to guide retro discussion
python ../../project-management/scrum-master/scripts/retrospective_analyzer.py retro_notes.json > retro_analysis.txt
python ../../project-management/skills/scrum-master/scripts/retrospective_analyzer.py retro_notes.json > retro_analysis.txt
cat retro_analysis.txt
```
@ -328,22 +328,22 @@ cat retro_analysis.txt
- Define priority scheme and SLA targets
3. **Design Workflows** - Build workflows matching team process:
- Reference: `../../project-management/jira-expert/references/WORKFLOWS.md`
- Reference: `../../project-management/skills/jira-expert/references/WORKFLOWS.md`
- Map states: Backlog > Ready > In Progress > Review > QA > Done
- Add transitions with conditions (e.g., assignee required for In Progress)
- Configure validators (e.g., story points required before Done)
- Set up post-functions (e.g., auto-assign reviewer, notify channel)
4. **Configure Automation** - Set up time-saving automation rules:
- Reference: `../../project-management/jira-expert/references/AUTOMATION.md`
- Examples from: `../../project-management/jira-expert/references/automation-examples.md`
- Reference: `../../project-management/skills/jira-expert/references/AUTOMATION.md`
- Examples from: `../../project-management/skills/jira-expert/references/automation-examples.md`
- Auto-transition: Move to In Progress when branch created
- Auto-assign: Rotate assignments based on workload
- Notifications: Slack alerts for blocked items, SLA breaches
- Cleanup: Auto-close stale items after 30 days
5. **Set Up Confluence Space** - Create team knowledge base:
- Reference: `../../project-management/confluence-expert/references/templates.md`
- Reference: `../../project-management/skills/confluence-expert/references/templates.md`
- Create space with standard page hierarchy:
- Home (team overview, quick links)
- Sprint Plans (per-sprint documentation)
@ -357,7 +357,7 @@ cat retro_analysis.txt
- Burndown/burnup chart gadget
- Velocity chart for historical tracking
- SLA compliance tracker
- Use JQL patterns from `../../project-management/jira-expert/references/jql-examples.md`
- Use JQL patterns from `../../project-management/skills/jira-expert/references/jql-examples.md`
7. **Onboard Team** - Walk team through the setup:
- Document workflow rules and why they exist
@ -383,22 +383,22 @@ echo "============================================"
# Sprint health assessment
echo ""
echo "Sprint Health:"
python ../../project-management/scrum-master/scripts/sprint_health_scorer.py current_sprint.json
python ../../project-management/skills/scrum-master/scripts/sprint_health_scorer.py current_sprint.json
# Velocity trend
echo ""
echo "Velocity Trend:"
python ../../project-management/scrum-master/scripts/velocity_analyzer.py sprint_history.json
python ../../project-management/skills/scrum-master/scripts/velocity_analyzer.py sprint_history.json
# Risk exposure
echo ""
echo "Active Risks:"
python ../../project-management/senior-pm/scripts/risk_matrix_analyzer.py active_risks.json
python ../../project-management/skills/senior-pm/scripts/risk_matrix_analyzer.py active_risks.json
# Resource utilization
echo ""
echo "Team Capacity:"
python ../../project-management/senior-pm/scripts/resource_capacity_planner.py team_data.json
python ../../project-management/skills/senior-pm/scripts/resource_capacity_planner.py team_data.json
```
### Example 2: Sprint Retrospective Pipeline
@ -414,19 +414,19 @@ echo "=========================================="
# Step 1: Score sprint health
echo ""
echo "1. Sprint Health Score:"
python ../../project-management/scrum-master/scripts/sprint_health_scorer.py sprint_${SPRINT_NUM}.json > sprint_health.txt
python ../../project-management/skills/scrum-master/scripts/sprint_health_scorer.py sprint_${SPRINT_NUM}.json > sprint_health.txt
cat sprint_health.txt
# Step 2: Analyze velocity trend
echo ""
echo "2. Velocity Analysis:"
python ../../project-management/scrum-master/scripts/velocity_analyzer.py velocity_history.json > velocity.txt
python ../../project-management/skills/scrum-master/scripts/velocity_analyzer.py velocity_history.json > velocity.txt
cat velocity.txt
# Step 3: Process retro notes
echo ""
echo "3. Retrospective Themes:"
python ../../project-management/scrum-master/scripts/retrospective_analyzer.py retro_sprint_${SPRINT_NUM}.json > retro_analysis.txt
python ../../project-management/skills/scrum-master/scripts/retrospective_analyzer.py retro_sprint_${SPRINT_NUM}.json > retro_analysis.txt
cat retro_analysis.txt
echo ""
@ -446,24 +446,24 @@ echo "================================"
# Project health across portfolio
echo ""
echo "Project Health (All Active):"
python ../../project-management/senior-pm/scripts/project_health_dashboard.py portfolio_$MONTH.json > dashboard.txt
python ../../project-management/skills/senior-pm/scripts/project_health_dashboard.py portfolio_$MONTH.json > dashboard.txt
cat dashboard.txt
# Risk heatmap
echo ""
echo "Risk Exposure Summary:"
python ../../project-management/senior-pm/scripts/risk_matrix_analyzer.py risks_$MONTH.json > risks.txt
python ../../project-management/skills/senior-pm/scripts/risk_matrix_analyzer.py risks_$MONTH.json > risks.txt
cat risks.txt
# Resource forecast
echo ""
echo "Resource Utilization:"
python ../../project-management/senior-pm/scripts/resource_capacity_planner.py resources_$MONTH.json > capacity.txt
python ../../project-management/skills/senior-pm/scripts/resource_capacity_planner.py resources_$MONTH.json > capacity.txt
cat capacity.txt
echo ""
echo "Dashboard generated. Use executive_report_template.md to assemble final report."
echo "Template: ../../project-management/senior-pm/assets/executive_report_template.md"
echo "Template: ../../project-management/skills/senior-pm/assets/executive_report_template.md"
```
## Success Metrics
@ -500,11 +500,11 @@ echo "Template: ../../project-management/senior-pm/assets/executive_report_templ
## References
- **Senior PM Skill:** [../../project-management/senior-pm/SKILL.md](../../project-management/senior-pm/SKILL.md)
- **Scrum Master Skill:** [../../project-management/scrum-master/SKILL.md](../../project-management/scrum-master/SKILL.md)
- **Jira Expert Skill:** [../../project-management/jira-expert/SKILL.md](../../project-management/jira-expert/SKILL.md)
- **Confluence Expert Skill:** [../../project-management/confluence-expert/SKILL.md](../../project-management/confluence-expert/SKILL.md)
- **Atlassian Admin Skill:** [../../project-management/atlassian-admin/SKILL.md](../../project-management/atlassian-admin/SKILL.md)
- **Senior PM Skill:** [../../project-management/skills/senior-pm/SKILL.md](../../project-management/skills/senior-pm/SKILL.md)
- **Scrum Master Skill:** [../../project-management/skills/scrum-master/SKILL.md](../../project-management/skills/scrum-master/SKILL.md)
- **Jira Expert Skill:** [../../project-management/skills/jira-expert/SKILL.md](../../project-management/skills/jira-expert/SKILL.md)
- **Confluence Expert Skill:** [../../project-management/skills/confluence-expert/SKILL.md](../../project-management/skills/confluence-expert/SKILL.md)
- **Atlassian Admin Skill:** [../../project-management/skills/atlassian-admin/SKILL.md](../../project-management/skills/atlassian-admin/SKILL.md)
- **PM Domain Guide:** [../../project-management/CLAUDE.md](../../project-management/CLAUDE.md)
- **Agent Development Guide:** [../CLAUDE.md](../CLAUDE.md)

6
business-growth/skills/business-growth-skills/SKILL.md
View file

@ -24,7 +24,7 @@ agents:
### Claude Code
```
/read business-growth/customer-success-manager/SKILL.md
/read business-growth/skills/customer-success-manager/SKILL.md
```
### Codex CLI
@ -46,8 +46,8 @@ npx agent-skills-cli add alirezarezvani/claude-skills/business-growth
9 scripts, all stdlib-only:
```bash
python3 customer-success-manager/scripts/health_score_calculator.py --help
python3 revenue-operations/scripts/pipeline_analyzer.py --help
python3 business-growth/skills/customer-success-manager/scripts/health_score_calculator.py --help
python3 business-growth/skills/revenue-operations/scripts/pipeline_analyzer.py --help
```
## Rules

6
business-growth/skills/sales-engineer/SKILL.md
View file

@ -211,9 +211,9 @@ python scripts/poc_planner.py poc_data.json --format json # JSON output
## Integration Points
- **Marketing Skills** - Leverage competitive intelligence and messaging frameworks from `../../marketing-skill/`
- **Product Team** - Coordinate on roadmap items flagged as "Planned" in RFP analysis from `../../product-team/`
- **C-Level Advisory** - Escalate strategic deals requiring executive engagement from `../../c-level-advisor/`
- **Marketing Skills** - Leverage competitive intelligence and messaging frameworks from `marketing-skill/`
- **Product Team** - Coordinate on roadmap items flagged as "Planned" in RFP analysis from `product-team/`
- **C-Level Advisory** - Escalate strategic deals requiring executive engagement from `c-level-advisor/`
- **Customer Success** - Hand off POC results and success criteria to CSM from `../customer-success-manager/`
---

2
c-level-advisor/c-level-agents/agents/cs-caio-advisor.md
View file

@ -158,7 +158,7 @@ python ../../skills/chief-ai-officer-advisor/scripts/ai_cost_economics.py worklo
## Related Agents
- [cs-cdo-advisor](cs-cdo-advisor.md) — Training data rights, data strategy (chains directly to model decisions)
- [cs-cto-advisor](../../../../agents/c-level/cs-cto-advisor.md) — Architecture capacity, scaling cliffs
- [cs-cto-advisor](../../../agents/c-level/cs-cto-advisor.md) — Architecture capacity, scaling cliffs
- [cs-ciso-advisor](cs-ciso-advisor.md) — Threat modeling for AI (prompt injection, jailbreak, training-data poisoning)
- [cs-general-counsel-advisor](cs-general-counsel-advisor.md) — AI contracts, vendor liability, output ownership
- [cs-cfo-advisor](cs-cfo-advisor.md) — Build-vs-buy TCO, multi-year vendor commitments

2
c-level-advisor/c-level-agents/agents/cs-cco-advisor.md
View file

@ -160,7 +160,7 @@ python ../../skills/chief-customer-officer-advisor/scripts/cs_coverage_calculato
- [cs-cmo-advisor](cs-cmo-advisor.md) — Customer marketing, advocacy, references
- [cs-cfo-advisor](cs-cfo-advisor.md) — CS team cost, retention-impact-on-revenue
- [cs-chro-advisor](cs-chro-advisor.md) — CS team hiring + leveling + comp
- [cs-growth-strategist](../../../../agents/business-growth/cs-growth-strategist.md) — Tactical CS execution
- [cs-growth-strategist](../../../agents/business-growth/cs-growth-strategist.md) — Tactical CS execution
## References

4
c-level-advisor/c-level-agents/agents/cs-cdo-advisor.md
View file

@ -104,7 +104,7 @@ python ../../skills/chief-data-officer-advisor/scripts/data_asset_valuator.py co
**Goal:** Sequence the next 18 months of data hires aligned to business decisions.
1. List top 5 decisions the business can't make today due to missing data/analysis
2. Map each decision to the role that unblocks it (see references/data_team_org_evolution.md)
2. Map each decision to the role that unblocks it (see ../../skills/chief-data-officer-advisor/references/data_team_org_evolution.md)
3. Sequence hires (one at a time, ramp before next)
4. Cross-check with cs-chro-advisor on comp bands + leveling
5. Identify centralize-vs-embed trigger date
@ -144,7 +144,7 @@ echo "Kill criteria + checkpoint dates in each output."
## Related Agents
- [cs-cto-advisor](../../../../agents/c-level/cs-cto-advisor.md) — architecture capacity
- [cs-cto-advisor](../../../agents/c-level/cs-cto-advisor.md) — architecture capacity
- [cs-ciso-advisor](cs-ciso-advisor.md) — data security, threat modeling for productized data
- [cs-cpo-advisor](cs-cpo-advisor.md) — product strategy (when data becomes product)
- [cs-general-counsel-advisor](cs-general-counsel-advisor.md) — contractual constraints, DPA, training-rights

4
c-level-advisor/c-level-agents/agents/cs-cfo-advisor.md
View file

@ -114,9 +114,9 @@ echo "Artifacts ready in /tmp/. Feed into /cs:boardroom brief."
## Related Agents
- [cs-ceo-advisor](../../../../agents/c-level/cs-ceo-advisor.md) — strategy & capital allocation partner
- [cs-ceo-advisor](../../../agents/c-level/cs-ceo-advisor.md) — strategy & capital allocation partner
- [cs-cro-advisor](cs-cro-advisor.md) — revenue forecast feed
- [cs-financial-analyst](../../../../agents/finance/cs-financial-analyst.md) — deep modeling
- [cs-financial-analyst](../../../agents/finance/cs-financial-analyst.md) — deep modeling
- [cs-chief-of-staff](cs-chief-of-staff.md) — routes financial questions here
## References

6
c-level-advisor/c-level-agents/agents/cs-chief-of-staff.md
View file

@ -29,8 +29,8 @@ This is the agent the founder talks to **first**. It pulls company-context.md, p
### Knowledge Bases
- `../../skills/chief-of-staff/references/routing_logic.md` — keywords → role mapping, multi-role triggers
- `../../skills/chief-of-staff/references/synthesis_patterns.md` — how to combine inputs from multiple advisors
- `../../skills/chief-of-staff/references/routing-matrix.md` — keywords → role mapping, multi-role triggers
- `../../skills/chief-of-staff/references/synthesis-framework.md` — how to combine inputs from multiple advisors
### Coordination Skills
@ -119,7 +119,7 @@ echo "Decision logged to ~/.claude/decisions/raw/$(date +%Y-%m-%d)-$RANDOM.md"
## Related Agents
- All cs-* C-level advisors (routes to them)
- [cs-ceo-advisor](../../../../agents/c-level/cs-ceo-advisor.md) — primary upward report
- [cs-ceo-advisor](../../../agents/c-level/cs-ceo-advisor.md) — primary upward report
- [executive-mentor / devils-advocate](../../executive-mentor/agents/devils-advocate.md) — pre-decision adversarial check
## References

12
c-level-advisor/c-level-agents/agents/cs-chro-advisor.md
View file

@ -39,9 +39,9 @@ Pairs with `cs-coo-advisor` (org design), `cs-cfo-advisor` (comp budget), and `c
### Knowledge Bases
- `../../skills/chro-advisor/references/hiring_systems.md` — sourcing channels, interview rubrics, scorecards, time-to-fill
- `../../skills/chro-advisor/references/comp_philosophy.md` — band design, equity strategy, refresh policy
- `../../skills/chro-advisor/references/leveling_ladders.md` — IC + manager tracks, level expectations, promotion criteria
- `../../skills/chro-advisor/references/people_strategy.md` — sourcing channels, interview rubrics, scorecards, time-to-fill
- `../../skills/chro-advisor/references/comp_frameworks.md` — band design, equity strategy, refresh policy
- `../../skills/chro-advisor/references/org_design.md` — IC + manager tracks, level expectations, promotion criteria
## Workflows
@ -92,7 +92,7 @@ python ../../skills/chro-advisor/scripts/hiring_plan_modeler.py
echo "👥 CHRO Quarterly Review"
python ../../skills/chro-advisor/scripts/hiring_plan_modeler.py
python ../../skills/chro-advisor/scripts/comp_benchmarker.py
echo "Ladder reference: ../../skills/chro-advisor/references/leveling_ladders.md"
echo "Ladder reference: ../../skills/chro-advisor/references/org_design.md"
```
## Success Metrics
@ -107,8 +107,8 @@ echo "Ladder reference: ../../skills/chro-advisor/references/leveling_ladders.md
- [cs-coo-advisor](cs-coo-advisor.md) — org design partner
- [cs-cfo-advisor](cs-cfo-advisor.md) — comp budget
- [cs-ceo-advisor](../../../../agents/c-level/cs-ceo-advisor.md) — exec team
- [cs-workspace-admin](../../../../agents/engineering-team/cs-workspace-admin.md) — onboarding tooling
- [cs-ceo-advisor](../../../agents/c-level/cs-ceo-advisor.md) — exec team
- [cs-workspace-admin](../../../agents/engineering-team/cs-workspace-admin.md) — onboarding tooling
## References

8
c-level-advisor/c-level-agents/agents/cs-ciso-advisor.md
View file

@ -39,7 +39,7 @@ Pairs with `cs-cto-advisor` (security architecture), `cs-cfo-advisor` (risk quan
### Knowledge Bases
- `../../skills/ciso-advisor/references/threat_modeling.md` — STRIDE, PASTA, attacker journey
- `../../skills/ciso-advisor/references/security_strategy.md` — STRIDE, PASTA, attacker journey
- `../../skills/ciso-advisor/references/compliance_roadmap.md` — SOC 2 Type 2, ISO 27001, GDPR sequencing
- `../../skills/ciso-advisor/references/incident_response.md` — IR runbooks, comms plan, regulator notification windows
@ -110,10 +110,10 @@ echo "IR runbook check: ../../skills/ciso-advisor/references/incident_response.m
## Related Agents
- [cs-cto-advisor](../../../../agents/c-level/cs-cto-advisor.md) — security architecture
- [cs-cto-advisor](../../../agents/c-level/cs-cto-advisor.md) — security architecture
- [cs-cfo-advisor](cs-cfo-advisor.md) — risk → insurance, audit budget
- [cs-quality-regulatory](../../../../agents/ra-qm-team/cs-quality-regulatory.md) — ISO 27001, GDPR execution
- [cs-senior-engineer](../../../../agents/engineering/cs-senior-engineer.md) — secure coding
- [cs-quality-regulatory](../../../agents/ra-qm-team/cs-quality-regulatory.md) — ISO 27001, GDPR execution
- [cs-senior-engineer](../../../agents/engineering/cs-senior-engineer.md) — secure coding
## References

8
c-level-advisor/c-level-agents/agents/cs-cmo-advisor.md
View file

@ -40,8 +40,8 @@ Pairs with `cs-cpo-advisor` (positioning ↔ product), `cs-cro-advisor` (positio
### Knowledge Bases
- `../../skills/cmo-advisor/references/brand_positioning.md` — category design, message house, narrative arcs
- `../../skills/cmo-advisor/references/growth_playbooks.md` — channel-specific motions, PLG vs sales-led
- `../../skills/cmo-advisor/references/marketing_operations.md` — attribution, cadence, content ops
- `../../skills/cmo-advisor/references/growth_frameworks.md` — channel-specific motions, PLG vs sales-led
- `../../skills/cmo-advisor/references/marketing_org.md` — attribution, cadence, content ops
### Adjacent Execution
@ -111,8 +111,8 @@ echo "📚 Reference: positioning + playbooks"
- [cs-cpo-advisor](cs-cpo-advisor.md) — positioning ↔ product alignment
- [cs-cro-advisor](cs-cro-advisor.md) — pipeline contribution
- [cs-content-creator](../../../../agents/marketing/cs-content-creator.md) — execution
- [cs-demand-gen-specialist](../../../../agents/marketing/cs-demand-gen-specialist.md) — execution
- [cs-content-creator](../../../agents/marketing/cs-content-creator.md) — execution
- [cs-demand-gen-specialist](../../../agents/marketing/cs-demand-gen-specialist.md) — execution
## References

10
c-level-advisor/c-level-agents/agents/cs-coo-advisor.md
View file

@ -39,9 +39,9 @@ Pairs with `cs-cfo-advisor` (finance cadence), `cs-cro-advisor` (revenue cadence
### Knowledge Bases
- `../../skills/coo-advisor/references/operating_cadence.md` — weekly/monthly/quarterly rhythm, meeting design
- `../../skills/coo-advisor/references/okr_execution.md` — OKR design, scoring, cascading
- `../../skills/coo-advisor/references/scaling_playbooks.md` — 1-10, 10-100, 100-1000 transitions
- `../../skills/coo-advisor/references/ops_cadence.md` — weekly/monthly/quarterly rhythm, meeting design
- `../../skills/coo-advisor/references/process_frameworks.md` — OKR design, scoring, cascading
- `../../skills/coo-advisor/references/scaling_playbook.md` — 1-10, 10-100, 100-1000 transitions
### Adjacent Skills
@ -97,7 +97,7 @@ python ../../skills/coo-advisor/scripts/okr_tracker.py
echo "⚙️ COO Quarterly Review"
python ../../skills/coo-advisor/scripts/okr_tracker.py
python ../../skills/coo-advisor/scripts/ops_efficiency_analyzer.py
echo "Reference: ../../skills/coo-advisor/references/operating_cadence.md"
echo "Reference: ../../skills/coo-advisor/references/ops_cadence.md"
```
## Success Metrics
@ -113,7 +113,7 @@ echo "Reference: ../../skills/coo-advisor/references/operating_cadence.md"
- [cs-cfo-advisor](cs-cfo-advisor.md) — finance cadence
- [cs-cro-advisor](cs-cro-advisor.md) — revenue cadence
- [cs-chief-of-staff](cs-chief-of-staff.md) — decision logging
- [cs-engineering-lead](../../../../agents/engineering-team/cs-engineering-lead.md) — eng ops
- [cs-engineering-lead](../../../agents/engineering-team/cs-engineering-lead.md) — eng ops
## References

14
c-level-advisor/c-level-agents/agents/cs-cpo-advisor.md
View file

@ -39,13 +39,13 @@ Pairs with `cs-cmo-advisor` (positioning ↔ product), `cs-cro-advisor` (win/los
### Knowledge Bases
- `../../skills/cpo-advisor/references/product_vision.md` — vision design, North Star metrics, opportunity solution tree
- `../../skills/cpo-advisor/references/portfolio_strategy.md` — 3-horizon, ROI vs strategic fit, kill criteria
- `../../skills/cpo-advisor/references/pmf_framework.md` — Sean Ellis, retention, organic pull, what PMF actually looks like
- `../../skills/cpo-advisor/references/product_strategy.md` — vision design, North Star metrics, opportunity solution tree
- `../../skills/cpo-advisor/references/product_org_design.md` — 3-horizon, ROI vs strategic fit, kill criteria
- `../../skills/cpo-advisor/references/pmf_playbook.md` — Sean Ellis, retention, organic pull, what PMF actually looks like
### Adjacent Execution
- `../../../../product-team/product-manager-toolkit/` — RICE, OKR cascade, user stories
- `../../../product-team/skills/product-manager-toolkit/` — RICE, OKR cascade, user stories
## Workflows
@ -96,7 +96,7 @@ python ../../skills/cpo-advisor/scripts/pmf_scorer.py
echo "✂️ CPO Portfolio Audit"
python ../../skills/cpo-advisor/scripts/portfolio_analyzer.py
python ../../skills/cpo-advisor/scripts/pmf_scorer.py
echo "Pair with RICE: python ../../../product-team/product-manager-toolkit/scripts/rice_prioritizer.py"
echo "Pair with RICE: python ../../../product-team/skills/product-manager-toolkit/scripts/rice_prioritizer.py"
```
## Success Metrics
@ -111,8 +111,8 @@ echo "Pair with RICE: python ../../../product-team/product-manager-toolkit/scrip
- [cs-cmo-advisor](cs-cmo-advisor.md) — positioning alignment
- [cs-cro-advisor](cs-cro-advisor.md) — win/loss feedback
- [cs-product-manager](../../../../agents/product/cs-product-manager.md) — execution
- [cs-product-strategist](../../../../agents/product/cs-product-strategist.md) — OKR cascade
- [cs-product-manager](../../../agents/product/cs-product-manager.md) — execution
- [cs-product-strategist](../../../agents/product/cs-product-strategist.md) — OKR cascade
## References

8
c-level-advisor/c-level-agents/agents/cs-cro-advisor.md
View file

@ -39,9 +39,9 @@ Pairs with `cs-cfo-advisor` (revenue → cash conversion), `cs-cmo-advisor` (pip
### Knowledge Bases
- `../../skills/cro-advisor/references/revenue_operations.md` — pipeline cadence, win/loss process, forecasting hygiene
- `../../skills/cro-advisor/references/sales_motion.md` — PLG vs sales-led, hiring profiles, ramp curves
- `../../skills/cro-advisor/references/retention_expansion.md` — NRR levers, customer success cadence, expansion plays
- `../../skills/cro-advisor/references/sales_playbook.md` — pipeline cadence, win/loss process, forecasting hygiene
- `../../skills/cro-advisor/references/pricing_strategy.md` — PLG vs sales-led, hiring profiles, ramp curves
- `../../skills/cro-advisor/references/nrr_playbook.md` — NRR levers, customer success cadence, expansion plays
## Workflows
@ -109,7 +109,7 @@ echo "Pipeline coverage and retention dashboard ready."
- [cs-cfo-advisor](cs-cfo-advisor.md) — revenue → cash conversion
- [cs-cmo-advisor](cs-cmo-advisor.md) — pipeline contribution
- [cs-cpo-advisor](cs-cpo-advisor.md) — product gaps in win/loss
- [cs-growth-strategist](../../../../agents/business-growth/cs-growth-strategist.md) — execution
- [cs-growth-strategist](../../../agents/business-growth/cs-growth-strategist.md) — execution
## References

4
c-level-advisor/c-level-agents/agents/cs-general-counsel-advisor.md
View file

@ -152,8 +152,8 @@ echo " ☐ /cs:freeze applied if irreversible (term sheet, M&A LOI, employment
- [cs-cfo-advisor](cs-cfo-advisor.md) — term sheet → dilution math
- [cs-ciso-advisor](cs-ciso-advisor.md) — data-touching contracts, compliance overlap
- [cs-ceo-advisor](../../../../agents/c-level/cs-ceo-advisor.md) — board / fundraising strategic context
- [cs-quality-regulatory](../../../../agents/ra-qm-team/cs-quality-regulatory.md) — regulated-industry execution (ISO 13485, MDR, FDA)
- [cs-ceo-advisor](../../../agents/c-level/cs-ceo-advisor.md) — board / fundraising strategic context
- [cs-quality-regulatory](../../../agents/ra-qm-team/cs-quality-regulatory.md) — regulated-industry execution (ISO 13485, MDR, FDA)
## References

4
c-level-advisor/c-level-agents/agents/cs-vpe-advisor.md
View file

@ -145,11 +145,11 @@ python ../../skills/vpe-advisor/scripts/eng_team_structure_designer.py current-t
## Related Agents
- [cs-cto-advisor](../../../../agents/c-level/cs-cto-advisor.md) — Architecture, scaling cliffs (CTO decides what to build; VPE decides how to ship)
- [cs-cto-advisor](../../../agents/c-level/cs-cto-advisor.md) — Architecture, scaling cliffs (CTO decides what to build; VPE decides how to ship)
- [cs-chro-advisor](cs-chro-advisor.md) — Hiring systems (ladders, bands)
- [cs-coo-advisor](cs-coo-advisor.md) — Operating cadence company-wide
- [cs-cfo-advisor](cs-cfo-advisor.md) — Cost-per-hire envelope, eng budget
- [cs-engineering-lead](../../../../agents/engineering-team/cs-engineering-lead.md) — Day-to-day incident + on-call coordination
- [cs-engineering-lead](../../../agents/engineering-team/cs-engineering-lead.md) — Day-to-day incident + on-call coordination
## References

4
c-level-advisor/c-level-agents/skills/c-level-agents/SKILL.md
View file

@ -30,7 +30,7 @@ Each agent wraps an existing c-level skill and adds:
- Workflow orchestration tied to skill Python tools
- Output template: Bottom Line → What → Why → How to Act → Your Decision
See `../references/persona-voices.md` for voice specs.
See `../../references/persona-voices.md` for voice specs.
### 17 /cs:* Slash Commands (in `skills/`)
@ -90,7 +90,7 @@ User question
- **decision-logger** — every `/cs:decide` writes here
- **chief-of-staff** — routing layer the agent orchestrates
- **board-meeting** — protocol the `/cs:boardroom` command runs
- **llm-wiki** — optional persistent memory bridge (see `../references/llm-wiki-bridge.md`)
- **llm-wiki** — optional persistent memory bridge (see `../../references/llm-wiki-bridge.md`)
- **executive-mentor** — adversarial `/em:*` commands stack cleanly on top
## Design Principles

4
c-level-advisor/c-level-agents/skills/cpo-review/SKILL.md
View file

@ -37,7 +37,7 @@ The JTBD-driven builder cuts the roadmap in half. Six questions to surface what
### 4. RICE Score
**Reach, Impact, Confidence, Effort — what's the score and where does this rank in the queue?**
```bash
python ../../../../product-team/product-manager-toolkit/scripts/rice_prioritizer.py
python product-team/skills/product-manager-toolkit/scripts/rice_prioritizer.py
```
### 5. Opportunity Cost
@ -103,7 +103,7 @@ python ../../../../product-team/product-manager-toolkit/scripts/rice_prioritizer
- Agent: [`cs-cpo-advisor`](../../agents/cs-cpo-advisor.md)
- Skill: [`cpo-advisor`](../../../skills/cpo-advisor/SKILL.md)
- Execution: `../../../../product-team/product-manager-toolkit/`
- Execution: `product-team/skills/product-manager-toolkit/`
---

22
c-level-advisor/chief-ai-officer-advisor/skills/chief-ai-officer-advisor/SKILL.md
View file

@ -210,17 +210,17 @@ python scripts/ai_cost_economics.py workload.json
## Adjacent Skills
- `../chief-data-officer-advisor/` — Training data rights, data product strategy (chains directly to model decisions)
- `../cto-advisor/` — Architecture capacity, scaling cliffs (esp. for self-hosted inference)
- `../ciso-advisor/` — Threat modeling for AI (prompt injection, jailbreak, training data poisoning)
- `../general-counsel-advisor/` — AI contracts (vendor liability, output ownership, training-data licensing)
- `../cfo-advisor/` — Build-vs-buy TCO math, multi-year vendor commitments
- `../chro-advisor/` — AI team hiring + comp
- `../../../engineering/rag-architect/` — Tactical RAG implementation
- `../../../engineering/agent-designer/` — Tactical agent architecture
- `../../../engineering/prompt-governance/` — Tactical prompt management
- `../../../engineering/self-eval/` — Tactical eval infrastructure
- `../../../engineering/llm-cost-optimizer/` — Tactical inference cost optimization
- `c-level-advisor/skills/chief-data-officer-advisor/` — Training data rights, data product strategy (chains directly to model decisions)
- `c-level-advisor/skills/cto-advisor/` — Architecture capacity, scaling cliffs (esp. for self-hosted inference)
- `c-level-advisor/skills/ciso-advisor/` — Threat modeling for AI (prompt injection, jailbreak, training data poisoning)
- `c-level-advisor/skills/general-counsel-advisor/` — AI contracts (vendor liability, output ownership, training-data licensing)
- `c-level-advisor/skills/cfo-advisor/` — Build-vs-buy TCO math, multi-year vendor commitments
- `c-level-advisor/skills/chro-advisor/` — AI team hiring + comp
- `engineering/skills/rag-architect/` — Tactical RAG implementation
- `engineering/skills/agent-designer/` — Tactical agent architecture
- `engineering/prompt-governance/` — Tactical prompt management
- `engineering/skills/self-eval/` — Tactical eval infrastructure
- `engineering/llm-cost-optimizer/` — Tactical inference cost optimization
## References

12
c-level-advisor/chief-customer-officer-advisor/skills/chief-customer-officer-advisor/SKILL.md
View file

@ -189,12 +189,12 @@ python scripts/cs_coverage_calculator.py book.json
## Adjacent Skills
- `../cro-advisor/` — Revenue math, NRR, expansion comp (CCO owns customer experience; CRO owns revenue math; clean split)
- `../cpo-advisor/` — Product strategy, JTBD (CCO surfaces product gaps; CPO decides roadmap)
- `../cmo-advisor/` — Customer marketing, advocacy, references
- `../cfo-advisor/` — CS team cost, retention-impact-on-revenue math
- `../chro-advisor/` — CS team hiring + leveling
- `../../../business-growth/` — Tactical CS execution: health scores, CRM workflows, onboarding tooling
- `c-level-advisor/skills/cro-advisor/` — Revenue math, NRR, expansion comp (CCO owns customer experience; CRO owns revenue math; clean split)
- `c-level-advisor/skills/cpo-advisor/` — Product strategy, JTBD (CCO surfaces product gaps; CPO decides roadmap)
- `c-level-advisor/skills/cmo-advisor/` — Customer marketing, advocacy, references
- `c-level-advisor/skills/cfo-advisor/` — CS team cost, retention-impact-on-revenue math
- `c-level-advisor/skills/chro-advisor/` — CS team hiring + leveling
- `business-growth/` — Tactical CS execution: health scores, CRM workflows, onboarding tooling
## References

16
c-level-advisor/chief-data-officer-advisor/skills/chief-data-officer-advisor/SKILL.md
View file

@ -182,14 +182,14 @@ python scripts/data_product_strategy_picker.py profile.json
## Adjacent Skills
- `../cto-advisor/` — architecture capacity, scaling cliffs
- `../ciso-advisor/` — data security, threat modeling for productized data
- `../general-counsel-advisor/` — contractual constraints, DPA, training-data rights
- `../cfo-advisor/` — build-vs-buy TCO, M&A valuation math
- `../chro-advisor/` — data team hiring, leveling, comp
- `../../../engineering/database-designer/` — tactical schema design
- `../../../engineering/rag-architect/` — tactical AI/RAG implementation
- `../../../engineering/llm-cost-optimizer/` — model cost management
- `c-level-advisor/skills/cto-advisor/` — architecture capacity, scaling cliffs
- `c-level-advisor/skills/ciso-advisor/` — data security, threat modeling for productized data
- `c-level-advisor/skills/general-counsel-advisor/` — contractual constraints, DPA, training-data rights
- `c-level-advisor/skills/cfo-advisor/` — build-vs-buy TCO, M&A valuation math
- `c-level-advisor/skills/chro-advisor/` — data team hiring, leveling, comp
- `engineering/skills/database-designer/` — tactical schema design
- `engineering/skills/rag-architect/` — tactical AI/RAG implementation
- `engineering/llm-cost-optimizer/` — model cost management
## References

12
c-level-advisor/executive-mentor/skills/executive-mentor/SKILL.md
View file

@ -71,19 +71,19 @@ This isn't therapy. It's preparation.
## Commands in Detail
### `/em:challenge <plan>`
Takes any plan — roadmap, GTM, hiring, fundraising — and finds what breaks first. Identifies assumptions, rates confidence, maps dependencies. Output: numbered vulnerabilities with severity (Critical / High / Medium). See `skills/challenge/SKILL.md`
Takes any plan — roadmap, GTM, hiring, fundraising — and finds what breaks first. Identifies assumptions, rates confidence, maps dependencies. Output: numbered vulnerabilities with severity (Critical / High / Medium). See `../challenge/SKILL.md`
### `/em:board-prep <agenda>`
48 hours before investors. What are the 10 hardest questions? What data do you need cold? How do you build a narrative that acknowledges weakness without losing the room? Prepares you for the adversarial board, not the friendly one. See `skills/board-prep/SKILL.md`
48 hours before investors. What are the 10 hardest questions? What data do you need cold? How do you build a narrative that acknowledges weakness without losing the room? Prepares you for the adversarial board, not the friendly one. See `../board-prep/SKILL.md`
### `/em:hard-call <decision>`
Reversibility test. 10/10/10 framework. Stakeholder impact mapping. Communication planning. For decisions with no good answer — only less bad ones. See `skills/hard-call/SKILL.md`
Reversibility test. 10/10/10 framework. Stakeholder impact mapping. Communication planning. For decisions with no good answer — only less bad ones. See `../hard-call/SKILL.md`
### `/em:stress-test <assumption>`
"$5B market." "$2M ARR by December." "3-year moat." Every plan is built on assumptions. Surfaces counter-evidence, models the downside, proposes the hedge. See `skills/stress-test/SKILL.md`
"$5B market." "$2M ARR by December." "3-year moat." Every plan is built on assumptions. Surfaces counter-evidence, models the downside, proposes the hedge. See `../stress-test/SKILL.md`
### `/em:postmortem <event>`
Lost deal. Failed feature. Missed quarter. No blame sessions, no whitewash. 5 Whys without softening, contributing factors vs root cause, owners per change, verification dates. See `skills/postmortem/SKILL.md`
Lost deal. Failed feature. Missed quarter. No blame sessions, no whitewash. 5 Whys without softening, contributing factors vs root cause, owners per change, verification dates. See `../postmortem/SKILL.md`
## Agents & References
@ -128,7 +128,7 @@ Assume the plan will fail. Find the three most likely failure modes. For each, i
## Communication
All output passes the Internal Quality Loop before reaching the founder (see `agent-protocol/SKILL.md`).
All output passes the Internal Quality Loop before reaching the founder (see `c-level-advisor/skills/agent-protocol/SKILL.md`).
- Self-verify: source attribution, assumption audit, confidence scoring
- Peer-verify: cross-functional claims validated by the owning role
- Critic pre-screen: high-stakes decisions reviewed by Executive Mentor

4
c-level-advisor/executive-mentor/skills/hard-call/SKILL.md
View file

@ -91,7 +91,7 @@ Hard decisions almost always get harder if communication is bad. The decision it
For every hard call, plan:
- **Who needs to know first** (the person directly affected, before anyone else)
- **How you'll tell them** (in person when possible, never via email for personal impact)
- **What you'll say** (honest, direct, compassionate — see `references/hard_things.md`)
- **What you'll say** (honest, direct, compassionate — see `../executive-mentor/references/hard_things.md`)
- **What they can ask** (be ready for every question)
- **What comes next** (give them a clear picture of what happens after)
@ -100,7 +100,7 @@ For every hard call, plan:
## Decision-Specific Frameworks
### Firing a Co-Founder
See `references/hard_things.md — Co-Founder Conflicts` for full framework.
See `../executive-mentor/references/hard_things.md — Co-Founder Conflicts` for full framework.
Key questions to answer first:
- Is this a performance problem or a values/culture problem? (Different conversations)

10
c-level-advisor/general-counsel-advisor/skills/general-counsel-advisor/SKILL.md
View file

@ -142,11 +142,11 @@ See `references/ip_and_regulatory.md` for sequencing.
## Adjacent Skills
- `../ciso-advisor/` — Compliance overlap (SOC 2, ISO 27001, HIPAA technical safeguards)
- `../cfo-advisor/` — Term sheet → dilution math
- `../ma-playbook/` — Acquisition agreements, integration playbooks
- `../../../ra-qm-team/` — ISO 13485, MDR, FDA 510(k), GDPR execution
- `../../c-level-agents/skills/gc-review/SKILL.md` — `/cs:gc-review` slash command
- `c-level-advisor/skills/ciso-advisor/` — Compliance overlap (SOC 2, ISO 27001, HIPAA technical safeguards)
- `c-level-advisor/skills/cfo-advisor/` — Term sheet → dilution math
- `c-level-advisor/skills/ma-playbook/` — Acquisition agreements, integration playbooks
- `ra-qm-team/` — ISO 13485, MDR, FDA 510(k), GDPR execution
- `c-level-advisor/c-level-agents/skills/gc-review/SKILL.md` — `/cs:gc-review` slash command
## References

2
c-level-advisor/skills/board-meeting/SKILL.md
View file

@ -81,7 +81,7 @@ Checklist:
---
### PHASE 4: Synthesis
Chief of Staff delivers using the **Board Meeting Output** format (defined in `agent-protocol/SKILL.md`):
Chief of Staff delivers using the **Board Meeting Output** format (defined in `../agent-protocol/SKILL.md`):
- Decision Required (one sentence)
- Perspectives (one line per contributing role)
- Where They Agree / Where They Disagree

4
c-level-advisor/skills/c-level-skills/SKILL.md
View file

@ -149,5 +149,5 @@ Culture Architect, Company OS, Founder Coach, Strategic Alignment, Change Manage
## See Also
- `CLAUDE.md` — full architecture diagram and integration guide
- `agent-protocol/SKILL.md` — communication standard and quality loop details
- `chief-of-staff/SKILL.md` — routing matrix for all 28 skills
- `../agent-protocol/SKILL.md` — communication standard and quality loop details
- `../chief-of-staff/SKILL.md` — routing matrix for all 28 skills

2
c-level-advisor/skills/ceo-advisor/SKILL.md
View file

@ -150,7 +150,7 @@ Explore multiple futures. For every strategic decision, generate at least 3 path
## Communication
All output passes the Internal Quality Loop before reaching the founder (see `agent-protocol/SKILL.md`).
All output passes the Internal Quality Loop before reaching the founder (see `../agent-protocol/SKILL.md`).
- Self-verify: source attribution, assumption audit, confidence scoring
- Peer-verify: cross-functional claims validated by the owning role
- Critic pre-screen: high-stakes decisions reviewed by Executive Mentor

2
c-level-advisor/skills/cfo-advisor/SKILL.md
View file

@ -126,7 +126,7 @@ Work through financial logic step by step. Show all math. Be conservative in pro
## Communication
All output passes the Internal Quality Loop before reaching the founder (see `agent-protocol/SKILL.md`).
All output passes the Internal Quality Loop before reaching the founder (see `../agent-protocol/SKILL.md`).
- Self-verify: source attribution, assumption audit, confidence scoring
- Peer-verify: cross-functional claims validated by the owning role
- Critic pre-screen: high-stakes decisions reviewed by Executive Mentor

22
c-level-advisor/skills/chief-ai-officer-advisor/SKILL.md
View file

@ -210,17 +210,17 @@ python scripts/ai_cost_economics.py workload.json
## Adjacent Skills
- `../chief-data-officer-advisor/` — Training data rights, data product strategy (chains directly to model decisions)
- `../cto-advisor/` — Architecture capacity, scaling cliffs (esp. for self-hosted inference)
- `../ciso-advisor/` — Threat modeling for AI (prompt injection, jailbreak, training data poisoning)
- `../general-counsel-advisor/` — AI contracts (vendor liability, output ownership, training-data licensing)
- `../cfo-advisor/` — Build-vs-buy TCO math, multi-year vendor commitments
- `../chro-advisor/` — AI team hiring + comp
- `../../../engineering/rag-architect/` — Tactical RAG implementation
- `../../../engineering/agent-designer/` — Tactical agent architecture
- `../../../engineering/prompt-governance/` — Tactical prompt management
- `../../../engineering/self-eval/` — Tactical eval infrastructure
- `../../../engineering/llm-cost-optimizer/` — Tactical inference cost optimization
- `c-level-advisor/skills/chief-data-officer-advisor/` — Training data rights, data product strategy (chains directly to model decisions)
- `c-level-advisor/skills/cto-advisor/` — Architecture capacity, scaling cliffs (esp. for self-hosted inference)
- `c-level-advisor/skills/ciso-advisor/` — Threat modeling for AI (prompt injection, jailbreak, training data poisoning)
- `c-level-advisor/skills/general-counsel-advisor/` — AI contracts (vendor liability, output ownership, training-data licensing)
- `c-level-advisor/skills/cfo-advisor/` — Build-vs-buy TCO math, multi-year vendor commitments
- `c-level-advisor/skills/chro-advisor/` — AI team hiring + comp
- `engineering/skills/rag-architect/` — Tactical RAG implementation
- `engineering/skills/agent-designer/` — Tactical agent architecture
- `engineering/prompt-governance/` — Tactical prompt management
- `engineering/skills/self-eval/` — Tactical eval infrastructure
- `engineering/llm-cost-optimizer/` — Tactical inference cost optimization
## References

12
c-level-advisor/skills/chief-customer-officer-advisor/SKILL.md
View file

@ -189,12 +189,12 @@ python scripts/cs_coverage_calculator.py book.json
## Adjacent Skills
- `../cro-advisor/` — Revenue math, NRR, expansion comp (CCO owns customer experience; CRO owns revenue math; clean split)
- `../cpo-advisor/` — Product strategy, JTBD (CCO surfaces product gaps; CPO decides roadmap)
- `../cmo-advisor/` — Customer marketing, advocacy, references
- `../cfo-advisor/` — CS team cost, retention-impact-on-revenue math
- `../chro-advisor/` — CS team hiring + leveling
- `../../../business-growth/` — Tactical CS execution: health scores, CRM workflows, onboarding tooling
- `c-level-advisor/skills/cro-advisor/` — Revenue math, NRR, expansion comp (CCO owns customer experience; CRO owns revenue math; clean split)
- `c-level-advisor/skills/cpo-advisor/` — Product strategy, JTBD (CCO surfaces product gaps; CPO decides roadmap)
- `c-level-advisor/skills/cmo-advisor/` — Customer marketing, advocacy, references
- `c-level-advisor/skills/cfo-advisor/` — CS team cost, retention-impact-on-revenue math
- `c-level-advisor/skills/chro-advisor/` — CS team hiring + leveling
- `business-growth/` — Tactical CS execution: health scores, CRM workflows, onboarding tooling
## References

16
c-level-advisor/skills/chief-data-officer-advisor/SKILL.md
View file

@ -182,14 +182,14 @@ python scripts/data_product_strategy_picker.py profile.json
## Adjacent Skills
- `../cto-advisor/` — architecture capacity, scaling cliffs
- `../ciso-advisor/` — data security, threat modeling for productized data
- `../general-counsel-advisor/` — contractual constraints, DPA, training-data rights
- `../cfo-advisor/` — build-vs-buy TCO, M&A valuation math
- `../chro-advisor/` — data team hiring, leveling, comp
- `../../../engineering/database-designer/` — tactical schema design
- `../../../engineering/rag-architect/` — tactical AI/RAG implementation
- `../../../engineering/llm-cost-optimizer/` — model cost management
- `c-level-advisor/skills/cto-advisor/` — architecture capacity, scaling cliffs
- `c-level-advisor/skills/ciso-advisor/` — data security, threat modeling for productized data
- `c-level-advisor/skills/general-counsel-advisor/` — contractual constraints, DPA, training-data rights
- `c-level-advisor/skills/cfo-advisor/` — build-vs-buy TCO, M&A valuation math
- `c-level-advisor/skills/chro-advisor/` — data team hiring, leveling, comp
- `engineering/skills/database-designer/` — tactical schema design
- `engineering/skills/rag-architect/` — tactical AI/RAG implementation
- `engineering/llm-cost-optimizer/` — model cost management
## References

2
c-level-advisor/skills/chief-of-staff/SKILL.md
View file

@ -151,7 +151,7 @@ At session start: if a review date has passed, flag it: *"You decided [X] on [da
## Quality Standards
Before delivering ANY output to the founder:
- [ ] Follows User Communication Standard (see `agent-protocol/SKILL.md`)
- [ ] Follows User Communication Standard (see `../agent-protocol/SKILL.md`)
- [ ] Bottom line is first — no preamble, no process narration
- [ ] Company context loaded (not generic advice)
- [ ] Every finding has WHAT + WHY + HOW

2
c-level-advisor/skills/chro-advisor/SKILL.md
View file

@ -130,7 +130,7 @@ Start with the human impact, then validate with metrics. Every people decision m
## Communication
All output passes the Internal Quality Loop before reaching the founder (see `agent-protocol/SKILL.md`).
All output passes the Internal Quality Loop before reaching the founder (see `../agent-protocol/SKILL.md`).
- Self-verify: source attribution, assumption audit, confidence scoring
- Peer-verify: cross-functional claims validated by the owning role
- Critic pre-screen: high-stakes decisions reviewed by Executive Mentor

2
c-level-advisor/skills/ciso-advisor/SKILL.md
View file

@ -121,7 +121,7 @@ Evaluate every decision through probability × impact. Quantify risks in busines
## Communication
All output passes the Internal Quality Loop before reaching the founder (see `agent-protocol/SKILL.md`).
All output passes the Internal Quality Loop before reaching the founder (see `../agent-protocol/SKILL.md`).
- Self-verify: source attribution, assumption audit, confidence scoring
- Peer-verify: cross-functional claims validated by the owning role
- Critic pre-screen: high-stakes decisions reviewed by Executive Mentor

2
c-level-advisor/skills/cmo-advisor/SKILL.md
View file

@ -155,7 +155,7 @@ Draft a marketing strategy, then critique it from the customer's perspective. Re
## Communication
All output passes the Internal Quality Loop before reaching the founder (see `agent-protocol/SKILL.md`).
All output passes the Internal Quality Loop before reaching the founder (see `../agent-protocol/SKILL.md`).
- Self-verify: source attribution, assumption audit, confidence scoring
- Peer-verify: cross-functional claims validated by the owning role
- Critic pre-screen: high-stakes decisions reviewed by Executive Mentor

2
c-level-advisor/skills/coo-advisor/SKILL.md
View file

@ -123,7 +123,7 @@ Map processes sequentially. Identify each step, handoff, and decision point. Fin
## Communication
All output passes the Internal Quality Loop before reaching the founder (see `agent-protocol/SKILL.md`).
All output passes the Internal Quality Loop before reaching the founder (see `../agent-protocol/SKILL.md`).
- Self-verify: source attribution, assumption audit, confidence scoring
- Peer-verify: cross-functional claims validated by the owning role
- Critic pre-screen: high-stakes decisions reviewed by Executive Mentor

2
c-level-advisor/skills/cpo-advisor/SKILL.md
View file

@ -186,7 +186,7 @@ Decompose to fundamental user needs. Question every assumption about what custom
## Communication
All output passes the Internal Quality Loop before reaching the founder (see `agent-protocol/SKILL.md`).
All output passes the Internal Quality Loop before reaching the founder (see `../agent-protocol/SKILL.md`).
- Self-verify: source attribution, assumption audit, confidence scoring
- Peer-verify: cross-functional claims validated by the owning role
- Critic pre-screen: high-stakes decisions reviewed by Executive Mentor

2
c-level-advisor/skills/cro-advisor/SKILL.md
View file

@ -169,7 +169,7 @@ Pipeline math must be explicit: leads → MQLs → SQLs → opportunities → cl
## Communication
All output passes the Internal Quality Loop before reaching the founder (see `agent-protocol/SKILL.md`).
All output passes the Internal Quality Loop before reaching the founder (see `../agent-protocol/SKILL.md`).
- Self-verify: source attribution, assumption audit, confidence scoring
- Peer-verify: cross-functional claims validated by the owning role
- Critic pre-screen: high-stakes decisions reviewed by Executive Mentor

2
c-level-advisor/skills/cto-advisor/SKILL.md
View file

@ -238,7 +238,7 @@ Research the technical landscape first. Analyze options against constraints (tim
## Communication
All output passes the Internal Quality Loop before reaching the founder (see `agent-protocol/SKILL.md`).
All output passes the Internal Quality Loop before reaching the founder (see `../agent-protocol/SKILL.md`).
- Self-verify: source attribution, assumption audit, confidence scoring
- Peer-verify: cross-functional claims validated by the owning role
- Critic pre-screen: high-stakes decisions reviewed by Executive Mentor

10
c-level-advisor/skills/general-counsel-advisor/SKILL.md
View file

@ -142,11 +142,11 @@ See `references/ip_and_regulatory.md` for sequencing.
## Adjacent Skills
- `../ciso-advisor/` — Compliance overlap (SOC 2, ISO 27001, HIPAA technical safeguards)
- `../cfo-advisor/` — Term sheet → dilution math
- `../ma-playbook/` — Acquisition agreements, integration playbooks
- `../../../ra-qm-team/` — ISO 13485, MDR, FDA 510(k), GDPR execution
- `../../c-level-agents/skills/gc-review/SKILL.md` — `/cs:gc-review` slash command
- `c-level-advisor/skills/ciso-advisor/` — Compliance overlap (SOC 2, ISO 27001, HIPAA technical safeguards)
- `c-level-advisor/skills/cfo-advisor/` — Term sheet → dilution math
- `c-level-advisor/skills/ma-playbook/` — Acquisition agreements, integration playbooks
- `ra-qm-team/` — ISO 13485, MDR, FDA 510(k), GDPR execution
- `c-level-advisor/c-level-agents/skills/gc-review/SKILL.md` — `/cs:gc-review` slash command
## References

14
c-level-advisor/skills/vpe-advisor/SKILL.md
View file

@ -208,13 +208,13 @@ python ../../skills/vpe-advisor/scripts/eng_team_structure_designer.py team.json
## Adjacent Skills
- `../cto-advisor/` — Architecture, scaling cliffs, tech debt strategy (CTO decides what to build; VPE decides how to ship)
- `../chro-advisor/` — Hiring systems (ladders, bands, leveling rubrics company-wide); VPE owns eng-specific funnel execution
- `../coo-advisor/` — Operating cadence company-wide; VPE owns eng-specific cadence
- `../../../engineering/slo-architect/` — SLO design (tactical; VPE owns the policy that SLOs are required)
- `../../../engineering/chaos-engineering/` — Chaos experiment design (tactical resilience)
- `../../../engineering/feature-flags-architect/` — Progressive delivery (tactical deployment)
- `../../../engineering/kubernetes-operator/` — K8s operator pattern (tactical infra)
- `c-level-advisor/skills/cto-advisor/` — Architecture, scaling cliffs, tech debt strategy (CTO decides what to build; VPE decides how to ship)
- `c-level-advisor/skills/chro-advisor/` — Hiring systems (ladders, bands, leveling rubrics company-wide); VPE owns eng-specific funnel execution
- `c-level-advisor/skills/coo-advisor/` — Operating cadence company-wide; VPE owns eng-specific cadence
- `engineering/skills/slo-architect/` — SLO design (tactical; VPE owns the policy that SLOs are required)
- `engineering/skills/chaos-engineering/` — Chaos experiment design (tactical resilience)
- `engineering/skills/feature-flags-architect/` — Progressive delivery (tactical deployment)
- `engineering/skills/kubernetes-operator/` — K8s operator pattern (tactical infra)
- `cs-engineering-lead` agent — Day-to-day incident + on-call coordination (VPE owns the operating model that engineering-lead executes)
## References

14
c-level-advisor/vpe-advisor/skills/vpe-advisor/SKILL.md
View file

@ -208,13 +208,13 @@ python ../../skills/vpe-advisor/scripts/eng_team_structure_designer.py team.json
## Adjacent Skills
- `../cto-advisor/` — Architecture, scaling cliffs, tech debt strategy (CTO decides what to build; VPE decides how to ship)
- `../chro-advisor/` — Hiring systems (ladders, bands, leveling rubrics company-wide); VPE owns eng-specific funnel execution
- `../coo-advisor/` — Operating cadence company-wide; VPE owns eng-specific cadence
- `../../../engineering/slo-architect/` — SLO design (tactical; VPE owns the policy that SLOs are required)
- `../../../engineering/chaos-engineering/` — Chaos experiment design (tactical resilience)
- `../../../engineering/feature-flags-architect/` — Progressive delivery (tactical deployment)
- `../../../engineering/kubernetes-operator/` — K8s operator pattern (tactical infra)
- `c-level-advisor/skills/cto-advisor/` — Architecture, scaling cliffs, tech debt strategy (CTO decides what to build; VPE decides how to ship)
- `c-level-advisor/skills/chro-advisor/` — Hiring systems (ladders, bands, leveling rubrics company-wide); VPE owns eng-specific funnel execution
- `c-level-advisor/skills/coo-advisor/` — Operating cadence company-wide; VPE owns eng-specific cadence
- `engineering/skills/slo-architect/` — SLO design (tactical; VPE owns the policy that SLOs are required)
- `engineering/skills/chaos-engineering/` — Chaos experiment design (tactical resilience)
- `engineering/skills/feature-flags-architect/` — Progressive delivery (tactical deployment)
- `engineering/skills/kubernetes-operator/` — K8s operator pattern (tactical infra)
- `cs-engineering-lead` agent — Day-to-day incident + on-call coordination (VPE owns the operating model that engineering-lead executes)
## References

14
commands/a11y-audit.md
View file

@ -40,7 +40,7 @@ For each finding (starting with critical):
1. Read the affected file
2. Show the violation with context (before)
3. Apply the fix from `references/framework-a11y-patterns.md`
3. Apply the fix from `engineering-team/a11y-audit/skills/a11y-audit/references/framework-a11y-patterns.md`
4. Show the result (after)
**Auto-fixable issues** (apply without asking):
@ -76,9 +76,9 @@ Generate a markdown report at `a11y-report.md`:
## Skill Reference
- `engineering-team/a11y-audit/SKILL.md`
- `engineering-team/a11y-audit/scripts/a11y_scanner.py`
- `engineering-team/a11y-audit/scripts/contrast_checker.py`
- `engineering-team/a11y-audit/references/wcag-quick-ref.md`
- `engineering-team/a11y-audit/references/aria-patterns.md`
- `engineering-team/a11y-audit/references/framework-a11y-patterns.md`
- `engineering-team/a11y-audit/skills/a11y-audit/SKILL.md`
- `engineering-team/a11y-audit/skills/a11y-audit/scripts/a11y_scanner.py`
- `engineering-team/a11y-audit/skills/a11y-audit/scripts/contrast_checker.py`
- `engineering-team/a11y-audit/skills/a11y-audit/references/wcag-quick-ref.md`
- `engineering-team/a11y-audit/skills/a11y-audit/references/aria-patterns.md`
- `engineering-team/a11y-audit/skills/a11y-audit/references/framework-a11y-patterns.md`

6
commands/changelog.md
View file

@ -23,8 +23,8 @@ Generate Keep a Changelog entries from git history and validate commit message f
```
## Scripts
- `engineering/changelog-generator/scripts/generate_changelog.py` — Parse commits, render changelog (`--from-tag`, `--to-tag`, `--from-ref`, `--to-ref`, `--format markdown|json`)
- `engineering/changelog-generator/scripts/commit_linter.py` — Validate conventional commit format (`--from-ref`, `--to-ref`, `--strict`, `--format text|json`)
- `engineering/skills/changelog-generator/scripts/generate_changelog.py` — Parse commits, render changelog (`--from-tag`, `--to-tag`, `--from-ref`, `--to-ref`, `--format markdown|json`)
- `engineering/skills/changelog-generator/scripts/commit_linter.py` — Validate conventional commit format (`--from-ref`, `--to-ref`, `--strict`, `--format text|json`)
## Skill Reference
→ `engineering/changelog-generator/SKILL.md`
→ `engineering/skills/changelog-generator/SKILL.md`

8
commands/code-to-prd.md
View file

@ -72,7 +72,7 @@ A `prd/` directory containing:
## Skill Reference
- `product-team/code-to-prd/SKILL.md`
- `product-team/code-to-prd/scripts/codebase_analyzer.py`
- `product-team/code-to-prd/scripts/prd_scaffolder.py`
- `product-team/code-to-prd/references/prd-quality-checklist.md`
- `product-team/code-to-prd/skills/code-to-prd/SKILL.md`
- `product-team/code-to-prd/skills/code-to-prd/scripts/codebase_analyzer.py`
- `product-team/code-to-prd/skills/code-to-prd/scripts/prd_scaffolder.py`
- `product-team/code-to-prd/skills/code-to-prd/references/prd-quality-checklist.md`

4
commands/competitive-matrix.md
View file

@ -34,7 +34,7 @@ Build competitive matrices with weighted scoring, gap analysis, and market posit
```
## Scripts
- `product-team/competitive-teardown/scripts/competitive_matrix_builder.py` — Matrix builder
- `product-team/skills/competitive-teardown/scripts/competitive_matrix_builder.py` — Matrix builder
## Skill Reference
→ `product-team/competitive-teardown/SKILL.md`
→ `product-team/skills/competitive-teardown/SKILL.md`

4
commands/cs-aeo.md
View file

@ -154,8 +154,8 @@ Content for YMYL topics scoring below threshold is unlikely to be cited regardle
## Related
- Agent: [`cs-aeo`](../agents/cs-aeo.md)
- Skill: [`aeo`](../skills/aeo/SKILL.md)
- Agent: [`cs-aeo`](agents/marketing/cs-aeo.md)
- Skill: [`aeo`](marketing-skill/skills/aeo/SKILL.md)
- Companion: `/cs:seo-audit` (SEO + AEO often run together)
- Source: ported from [`alirezarezvani/aeo-box`](https://github.com/alirezarezvani/aeo-box)

2
commands/cs-webinar.md
View file

@ -32,7 +32,7 @@ The `cs-webinar` command is the **entry point for webinar workflows**: plan →
Walks the intake, locks the promise + format, sizes the funnel backward from the business goal,
builds the promotion runway, and designs show-up + live-to-close + follow-up. Delivers a full plan
using `templates/webinar-plan-template.md`.
using `marketing-skill/skills/webinar-marketing/templates/webinar-plan-template.md`.
### `rescue` — Diagnose and fix an underperforming webinar

10
commands/financial-health.md
View file

@ -26,13 +26,13 @@ Analyze financial statements, build valuation models, assess budget variances, a
```
## Scripts
- `finance/financial-analyst/scripts/ratio_calculator.py` — Profitability, liquidity, leverage, efficiency, valuation ratios
- `finance/financial-analyst/scripts/dcf_valuation.py` — DCF enterprise and equity valuation with sensitivity analysis
- `finance/financial-analyst/scripts/budget_variance_analyzer.py` — Actual vs budget vs prior year variance analysis
- `finance/financial-analyst/scripts/forecast_builder.py` — Driver-based revenue forecasting with scenario modeling
- `finance/skills/financial-analyst/scripts/ratio_calculator.py` — Profitability, liquidity, leverage, efficiency, valuation ratios
- `finance/skills/financial-analyst/scripts/dcf_valuation.py` — DCF enterprise and equity valuation with sensitivity analysis
- `finance/skills/financial-analyst/scripts/budget_variance_analyzer.py` — Actual vs budget vs prior year variance analysis
- `finance/skills/financial-analyst/scripts/forecast_builder.py` — Driver-based revenue forecasting with scenario modeling
## Skill Reference
→ `finance/financial-analyst/SKILL.md`
→ `finance/skills/financial-analyst/SKILL.md`
## Related Commands
- `/saas-health` — SaaS-specific metrics (ARR, MRR, churn, CAC, LTV, Quick Ratio)

30
commands/google-workspace.md
View file

@ -33,45 +33,45 @@ Google Workspace CLI administration via the `gws` CLI. Run setup diagnostics, se
## Scripts
- `engineering-team/google-workspace-cli/scripts/gws_doctor.py` — Pre-flight diagnostics
- `engineering-team/google-workspace-cli/scripts/auth_setup_guide.py` — Auth setup guide
- `engineering-team/google-workspace-cli/scripts/gws_recipe_runner.py` — Recipe catalog & runner
- `engineering-team/google-workspace-cli/scripts/workspace_audit.py` — Security audit
- `engineering-team/google-workspace-cli/scripts/output_analyzer.py` — JSON/NDJSON analyzer
- `engineering-team/google-workspace-cli/skills/google-workspace-cli/scripts/gws_doctor.py` — Pre-flight diagnostics
- `engineering-team/google-workspace-cli/skills/google-workspace-cli/scripts/auth_setup_guide.py` — Auth setup guide
- `engineering-team/google-workspace-cli/skills/google-workspace-cli/scripts/gws_recipe_runner.py` — Recipe catalog & runner
- `engineering-team/google-workspace-cli/skills/google-workspace-cli/scripts/workspace_audit.py` — Security audit
- `engineering-team/google-workspace-cli/skills/google-workspace-cli/scripts/output_analyzer.py` — JSON/NDJSON analyzer
## Subcommands
### setup
Run pre-flight diagnostics and auth validation.
```bash
python3 engineering-team/google-workspace-cli/scripts/gws_doctor.py [--json]
python3 engineering-team/google-workspace-cli/scripts/auth_setup_guide.py --validate [--json]
python3 engineering-team/google-workspace-cli/skills/google-workspace-cli/scripts/gws_doctor.py [--json]
python3 engineering-team/google-workspace-cli/skills/google-workspace-cli/scripts/auth_setup_guide.py --validate [--json]
```
### audit
Run security and configuration audit.
```bash
python3 engineering-team/google-workspace-cli/scripts/workspace_audit.py [--services gmail,drive,calendar] [--json]
python3 engineering-team/google-workspace-cli/skills/google-workspace-cli/scripts/workspace_audit.py [--services gmail,drive,calendar] [--json]
```
### recipe
Browse, search, and execute the 43 built-in gws recipes.
```bash
python3 engineering-team/google-workspace-cli/scripts/gws_recipe_runner.py --list [--persona <role>] [--json]
python3 engineering-team/google-workspace-cli/scripts/gws_recipe_runner.py --search <keyword> [--json]
python3 engineering-team/google-workspace-cli/scripts/gws_recipe_runner.py --describe <name>
python3 engineering-team/google-workspace-cli/scripts/gws_recipe_runner.py --run <name> [--dry-run]
python3 engineering-team/google-workspace-cli/skills/google-workspace-cli/scripts/gws_recipe_runner.py --list [--persona <role>] [--json]
python3 engineering-team/google-workspace-cli/skills/google-workspace-cli/scripts/gws_recipe_runner.py --search <keyword> [--json]
python3 engineering-team/google-workspace-cli/skills/google-workspace-cli/scripts/gws_recipe_runner.py --describe <name>
python3 engineering-team/google-workspace-cli/skills/google-workspace-cli/scripts/gws_recipe_runner.py --run <name> [--dry-run]
```
### analyze
Parse, filter, and aggregate JSON output from any gws command.
```bash
gws <command> --json | python3 engineering-team/google-workspace-cli/scripts/output_analyzer.py [options]
python3 engineering-team/google-workspace-cli/scripts/output_analyzer.py --demo --format table
gws <command> --json | python3 engineering-team/google-workspace-cli/skills/google-workspace-cli/scripts/output_analyzer.py [options]
python3 engineering-team/google-workspace-cli/skills/google-workspace-cli/scripts/output_analyzer.py --demo --format table
```
## Skill Reference
-> `engineering-team/google-workspace-cli/SKILL.md`
-> `engineering-team/google-workspace-cli/skills/google-workspace-cli/SKILL.md`
## Related Commands
- No direct dependencies (self-contained Google Workspace skill)

14
commands/karpathy-check.md
View file

@ -16,8 +16,8 @@ Review your staged changes (or last commit) against Karpathy's 4 coding principl
## What it runs
1. **Principle #2 (Simplicity):** `scripts/complexity_checker.py` on all changed files — detects over-engineering, premature abstractions, deep nesting, long functions
2. **Principle #3 (Surgical):** `scripts/diff_surgeon.py` on the diff — detects comment-only changes, whitespace noise, style drift, drive-by refactors
1. **Principle #2 (Simplicity):** `engineering/karpathy-coder/skills/karpathy-coder/scripts/complexity_checker.py` on all changed files — detects over-engineering, premature abstractions, deep nesting, long functions
2. **Principle #3 (Surgical):** `engineering/karpathy-coder/skills/karpathy-coder/scripts/diff_surgeon.py` on the diff — detects comment-only changes, whitespace noise, style drift, drive-by refactors
3. **Principles #1 + #4 (Think + Goals):** The `karpathy-reviewer` agent reads the diff and applies human-judgment checks — hidden assumptions, missing verification
## Output
@ -36,11 +36,11 @@ Dispatches the `karpathy-reviewer` agent. See `agents/karpathy-reviewer.md`.
## Scripts
- `engineering/karpathy-coder/scripts/complexity_checker.py`
- `engineering/karpathy-coder/scripts/diff_surgeon.py`
- `engineering/karpathy-coder/scripts/assumption_linter.py`
- `engineering/karpathy-coder/scripts/goal_verifier.py`
- `engineering/karpathy-coder/skills/karpathy-coder/scripts/complexity_checker.py`
- `engineering/karpathy-coder/skills/karpathy-coder/scripts/diff_surgeon.py`
- `engineering/karpathy-coder/skills/karpathy-coder/scripts/assumption_linter.py`
- `engineering/karpathy-coder/skills/karpathy-coder/scripts/goal_verifier.py`
## Skill Reference
→ `engineering/karpathy-coder/SKILL.md`
→ `engineering/karpathy-coder/skills/karpathy-coder/SKILL.md`

4
commands/okr.md
View file

@ -31,7 +31,7 @@ Pass a strategy keyword directly. The generator produces company, department, an
```
## Scripts
- `product-team/product-strategist/scripts/okr_cascade_generator.py` — OKR cascade generator (`<strategy> [--teams "A,B,C"] [--contribution 0.3] [--json]`)
- `product-team/skills/product-strategist/scripts/okr_cascade_generator.py` — OKR cascade generator (`<strategy> [--teams "A,B,C"] [--contribution 0.3] [--json]`)
## Skill Reference
> `product-team/product-strategist/SKILL.md`
> `product-team/skills/product-strategist/SKILL.md`

4
commands/persona.md
View file

@ -34,7 +34,7 @@ Interactive mode prompts for product context. Alternatively, provide context inl
```
## Scripts
- `product-team/ux-researcher-designer/scripts/persona_generator.py` — Persona generator (positional `json` arg for JSON output)
- `product-team/skills/ux-researcher-designer/scripts/persona_generator.py` — Persona generator (positional `json` arg for JSON output)
## Skill Reference
> `product-team/ux-researcher-designer/SKILL.md`
> `product-team/skills/ux-researcher-designer/SKILL.md`

6
commands/pipeline.md
View file

@ -23,8 +23,8 @@ Detect project stack and generate CI/CD pipeline configurations for GitHub Actio
```
## Scripts
- `engineering/ci-cd-pipeline-builder/scripts/stack_detector.py` — Detect stack and tooling (`--repo <path>`, `--format text|json`)
- `engineering/ci-cd-pipeline-builder/scripts/pipeline_generator.py` — Generate pipeline YAML (`--platform github|gitlab`, `--repo <path>`, `--input <stack.json>`, `--output <file>`)
- `engineering/skills/ci-cd-pipeline-builder/scripts/stack_detector.py` — Detect stack and tooling (`--repo <path>`, `--format text|json`)
- `engineering/skills/ci-cd-pipeline-builder/scripts/pipeline_generator.py` — Generate pipeline YAML (`--platform github|gitlab`, `--repo <path>`, `--input <stack.json>`, `--output <file>`)
## Skill Reference
→ `engineering/ci-cd-pipeline-builder/SKILL.md`
→ `engineering/skills/ci-cd-pipeline-builder/SKILL.md`

16
commands/plugin-audit.md
View file

@ -60,7 +60,7 @@ Auditing: code-to-prd
Run the skill-tester validator.
```bash
python3 engineering/skill-tester/scripts/skill_validator.py {skill_path} --tier {detected_tier} --json
python3 engineering/skills/skill-tester/scripts/skill_validator.py {skill_path} --tier {detected_tier} --json
```
Parse the JSON output. Extract:
@ -83,7 +83,7 @@ Parse the JSON output. Extract:
Run the quality scorer.
```bash
python3 engineering/skill-tester/scripts/quality_scorer.py {skill_path} --detailed --json
python3 engineering/skills/skill-tester/scripts/quality_scorer.py {skill_path} --detailed --json
```
Parse the JSON output. Extract:
@ -100,7 +100,7 @@ Parse the JSON output. Extract:
If the skill has `scripts/` with `.py` files, run the script tester.
```bash
python3 engineering/skill-tester/scripts/script_tester.py {skill_path} --json --verbose
python3 engineering/skills/skill-tester/scripts/script_tester.py {skill_path} --json --verbose
```
Parse the JSON output. For each script, extract:
@ -118,7 +118,7 @@ Parse the JSON output. For each script, extract:
Run the skill security auditor.
```bash
python3 engineering/skill-security-auditor/scripts/skill_security_auditor.py {skill_path} --strict --json
python3 engineering/skills/skill-security-auditor/scripts/skill_security_auditor.py {skill_path} --strict --json
```
Parse the JSON output. Extract:
@ -303,10 +303,10 @@ Present results as a structured table:
| Tool | Path |
|------|------|
| Skill Validator | `engineering/skill-tester/scripts/skill_validator.py` |
| Quality Scorer | `engineering/skill-tester/scripts/quality_scorer.py` |
| Script Tester | `engineering/skill-tester/scripts/script_tester.py` |
| Security Auditor | `engineering/skill-security-auditor/scripts/skill_security_auditor.py` |
| Skill Validator | `engineering/skills/skill-tester/scripts/skill_validator.py` |
| Quality Scorer | `engineering/skills/skill-tester/scripts/quality_scorer.py` |
| Script Tester | `engineering/skills/skill-tester/scripts/script_tester.py` |
| Security Auditor | `engineering/skills/skill-security-auditor/scripts/skill_security_auditor.py` |
| Quality Standards | `standards/quality/quality-standards.md` |
| Security Standards | `standards/security/security-standards.md` |
| Git Standards | `standards/git/git-workflow-standards.md` |

2
commands/prd.md
View file

@ -22,4 +22,4 @@ Generate a concise product requirements document for a feature, initiative, or p
- Scope and timeline assumptions
## Skill Reference
- `product-team/product-manager-toolkit/SKILL.md`
- `product-team/skills/product-manager-toolkit/SKILL.md`

6
commands/project-health.md
View file

@ -36,8 +36,8 @@ Generate portfolio health dashboards and risk matrices for project oversight.
```
## Scripts
- `project-management/senior-pm/scripts/project_health_dashboard.py` — Health dashboard (`<data_file> [--format text|json]`)
- `project-management/senior-pm/scripts/risk_matrix_analyzer.py` — Risk matrix analyzer (`<data_file> [--format text|json]`)
- `project-management/skills/senior-pm/scripts/project_health_dashboard.py` — Health dashboard (`<data_file> [--format text|json]`)
- `project-management/skills/senior-pm/scripts/risk_matrix_analyzer.py` — Risk matrix analyzer (`<data_file> [--format text|json]`)
## Skill Reference
> `project-management/senior-pm/SKILL.md`
> `project-management/skills/senior-pm/SKILL.md`

4
commands/retro.md
View file

@ -36,7 +36,7 @@ Analyze retrospective data for recurring themes, sentiment trends, and action it
```
## Scripts
- `project-management/scrum-master/scripts/retrospective_analyzer.py` — Retrospective analyzer (`<data_file> [--format text|json]`)
- `project-management/skills/scrum-master/scripts/retrospective_analyzer.py` — Retrospective analyzer (`<data_file> [--format text|json]`)
## Skill Reference
> `project-management/scrum-master/SKILL.md`
> `project-management/skills/scrum-master/SKILL.md`

4
commands/rice.md
View file

@ -33,7 +33,7 @@ Mobile app,20000,3,0.5,13
```
## Scripts
- `product-team/product-manager-toolkit/scripts/rice_prioritizer.py` — RICE prioritizer (`<input.csv> [--capacity N] [--output text|json|csv]`)
- `product-team/skills/product-manager-toolkit/scripts/rice_prioritizer.py` — RICE prioritizer (`<input.csv> [--capacity N] [--output text|json|csv]`)
## Skill Reference
> `product-team/product-manager-toolkit/SKILL.md`
> `product-team/skills/product-manager-toolkit/SKILL.md`

8
commands/saas-health.md
View file

@ -24,12 +24,12 @@ Calculate SaaS financial health metrics from raw business numbers, benchmark aga
```
## Scripts
- `finance/saas-metrics-coach/scripts/metrics_calculator.py` — Core SaaS metrics (ARR, MRR, churn, CAC, LTV, NRR, payback)
- `finance/saas-metrics-coach/scripts/quick_ratio_calculator.py` — Growth efficiency ratio
- `finance/saas-metrics-coach/scripts/unit_economics_simulator.py` — 12-month forward projection
- `finance/skills/saas-metrics-coach/scripts/metrics_calculator.py` — Core SaaS metrics (ARR, MRR, churn, CAC, LTV, NRR, payback)
- `finance/skills/saas-metrics-coach/scripts/quick_ratio_calculator.py` — Growth efficiency ratio
- `finance/skills/saas-metrics-coach/scripts/unit_economics_simulator.py` — 12-month forward projection
## Skill Reference
→ `finance/saas-metrics-coach/SKILL.md`
→ `finance/skills/saas-metrics-coach/SKILL.md`
## Related Commands
- `/financial-health` — Traditional financial analysis (ratios, DCF, budgets)

38
commands/seo-auditor.md
View file

@ -91,7 +91,7 @@ For every file with YAML frontmatter, check and fix:
Run on each file that has HTML output in `site/`:
```bash
python3 marketing-skill/seo-audit/scripts/seo_checker.py --file site/{path}/index.html
python3 marketing-skill/skills/seo-audit/scripts/seo_checker.py --file site/{path}/index.html
```
Parse the score. Flag any page scoring below 60.
@ -117,7 +117,7 @@ For each target file, analyze and improve:
Run the content scorer on each file:
```bash
python3 marketing-skill/content-production/scripts/content_scorer.py {file_path}
python3 marketing-skill/skills/content-production/scripts/content_scorer.py {file_path}
```
Check scores for:
@ -138,10 +138,10 @@ Check scores for:
Run the humanizer scorer on non-generated content (README.md files, static pages):
```bash
python3 marketing-skill/content-humanizer/scripts/humanizer_scorer.py {file_path}
python3 marketing-skill/skills/content-humanizer/scripts/humanizer_scorer.py {file_path}
```
Flag pages scoring below 50 (too AI-sounding). For these pages, apply voice techniques from `marketing-skill/content-humanizer/references/voice-techniques.md`:
Flag pages scoring below 50 (too AI-sounding). For these pages, apply voice techniques from `marketing-skill/skills/content-humanizer/references/voice-techniques.md`:
- Replace AI clichés ("delve into", "leverage", "it's important to note")
- Vary sentence length
- Add specific examples instead of generic statements
@ -242,7 +242,7 @@ This regenerates `site/sitemap.xml` automatically (MkDocs Material generates it
Check the generated sitemap:
```bash
python3 marketing-skill/site-architecture/scripts/sitemap_analyzer.py site/sitemap.xml
python3 marketing-skill/skills/site-architecture/scripts/sitemap_analyzer.py site/sitemap.xml
```
Verify:
@ -319,22 +319,22 @@ These pages rank well for their target keywords. Only fix critical issues (broke
| Tool | Path | Use |
|------|------|-----|
| SEO Checker | `marketing-skill/seo-audit/scripts/seo_checker.py` | Score HTML pages 0-100 |
| Content Scorer | `marketing-skill/content-production/scripts/content_scorer.py` | Score content readability/structure/engagement |
| Humanizer Scorer | `marketing-skill/content-humanizer/scripts/humanizer_scorer.py` | Detect AI-sounding content |
| Headline Scorer | `marketing-skill/copywriting/scripts/headline_scorer.py` | Score title quality |
| SEO Optimizer | `marketing-skill/content-production/scripts/seo_optimizer.py` | Optimize content for target keyword |
| Sitemap Analyzer | `marketing-skill/site-architecture/scripts/sitemap_analyzer.py` | Analyze sitemap structure |
| Schema Validator | `marketing-skill/schema-markup/scripts/schema_validator.py` | Validate structured data |
| Topic Cluster Mapper | `marketing-skill/content-strategy/scripts/topic_cluster_mapper.py` | Group pages into content clusters |
| SEO Checker | `marketing-skill/skills/seo-audit/scripts/seo_checker.py` | Score HTML pages 0-100 |
| Content Scorer | `marketing-skill/skills/content-production/scripts/content_scorer.py` | Score content readability/structure/engagement |
| Humanizer Scorer | `marketing-skill/skills/content-humanizer/scripts/humanizer_scorer.py` | Detect AI-sounding content |
| Headline Scorer | `marketing-skill/skills/copywriting/scripts/headline_scorer.py` | Score title quality |
| SEO Optimizer | `marketing-skill/skills/content-production/scripts/seo_optimizer.py` | Optimize content for target keyword |
| Sitemap Analyzer | `marketing-skill/skills/site-architecture/scripts/sitemap_analyzer.py` | Analyze sitemap structure |
| Schema Validator | `marketing-skill/skills/schema-markup/scripts/schema_validator.py` | Validate structured data |
| Topic Cluster Mapper | `marketing-skill/skills/content-strategy/scripts/topic_cluster_mapper.py` | Group pages into content clusters |
### Reference Docs
| Reference | Path | Use |
|-----------|------|-----|
| SEO Audit Framework | `marketing-skill/seo-audit/references/seo-audit-reference.md` | Priority order for SEO fixes |
| AI Search Optimization | `marketing-skill/ai-seo/references/content-patterns.md` | Make content citable by AI |
| Content Optimization | `marketing-skill/content-production/references/optimization-checklist.md` | Pre-publish checklist |
| URL Design Guide | `marketing-skill/site-architecture/references/url-design-guide.md` | URL structure best practices |
| Internal Linking | `marketing-skill/site-architecture/references/internal-linking-playbook.md` | Internal linking strategy |
| AI Writing Detection | `marketing-skill/content-humanizer/references/ai-tells-checklist.md` | AI cliché removal |
| SEO Audit Framework | `marketing-skill/skills/seo-audit/references/seo-audit-reference.md` | Priority order for SEO fixes |
| AI Search Optimization | `marketing-skill/skills/ai-seo/references/content-patterns.md` | Make content citable by AI |
| Content Optimization | `marketing-skill/skills/content-production/references/optimization-checklist.md` | Pre-publish checklist |
| URL Design Guide | `marketing-skill/skills/site-architecture/references/url-design-guide.md` | URL structure best practices |
| Internal Linking | `marketing-skill/skills/site-architecture/references/internal-linking-playbook.md` | Internal linking strategy |
| AI Writing Detection | `marketing-skill/skills/content-humanizer/references/ai-tells-checklist.md` | AI cliché removal |

6
commands/sprint-health.md
View file

@ -36,8 +36,8 @@ Score sprint health across delivery, quality, and team metrics with velocity tre
```
## Scripts
- `project-management/scrum-master/scripts/sprint_health_scorer.py` — Sprint health scorer (`<data_file> [--format text|json]`)
- `project-management/scrum-master/scripts/velocity_analyzer.py` — Velocity analyzer (`<data_file> [--format text|json]`)
- `project-management/skills/scrum-master/scripts/sprint_health_scorer.py` — Sprint health scorer (`<data_file> [--format text|json]`)
- `project-management/skills/scrum-master/scripts/velocity_analyzer.py` — Velocity analyzer (`<data_file> [--format text|json]`)
## Skill Reference
> `project-management/scrum-master/SKILL.md`
> `project-management/skills/scrum-master/SKILL.md`

2
commands/sprint-plan.md
View file

@ -22,4 +22,4 @@ Create a sprint plan with prioritized stories and capacity guardrails.
- Story-level acceptance criteria checks
## Skill Reference
- `product-team/agile-product-owner/SKILL.md`
- `product-team/agile-product-owner/skills/agile-product-owner/SKILL.md`

22
commands/tc.md
View file

@ -28,7 +28,7 @@ Otherwise, parse `$ARGUMENTS` as `<subcommand> <rest>` and dispatch to the match
1. Run:
```bash
python3 engineering/tc-tracker/scripts/tc_init.py --root . --json
python3 engineering/skills/tc-tracker/scripts/tc_init.py --root . --json
```
2. If status is `already_initialized`, report current statistics and stop.
3. Otherwise report what was created and suggest `/tc create <name>` as the next step.
@ -44,7 +44,7 @@ Otherwise, parse `$ARGUMENTS` as `<subcommand> <rest>` and dispatch to the match
- Motivation
3. Run:
```bash
python3 engineering/tc-tracker/scripts/tc_create.py --root . \
python3 engineering/skills/tc-tracker/scripts/tc_create.py --root . \
--name "<slug>" --title "<title>" --scope <scope> --priority <priority> \
--summary "<summary>" --motivation "<motivation>" --json
```
@ -62,7 +62,7 @@ Otherwise, parse `$ARGUMENTS` as `<subcommand> <rest>` and dispatch to the match
- **Add a tag** → `--tag <tag>`
3. Run:
```bash
python3 engineering/tc-tracker/scripts/tc_update.py --root . --tc-id <tc-id> [flags] --json
python3 engineering/skills/tc-tracker/scripts/tc_update.py --root . --tc-id <tc-id> [flags] --json
```
4. If exit code is non-zero, surface the error verbatim. The state machine and validator will reject invalid moves — do not retry blindly.
@ -70,24 +70,24 @@ Otherwise, parse `$ARGUMENTS` as `<subcommand> <rest>` and dispatch to the match
- If `<tc-id>` is provided:
```bash
python3 engineering/tc-tracker/scripts/tc_status.py --root . --tc-id <tc-id>
python3 engineering/skills/tc-tracker/scripts/tc_status.py --root . --tc-id <tc-id>
```
- Otherwise:
```bash
python3 engineering/tc-tracker/scripts/tc_status.py --root . --all
python3 engineering/skills/tc-tracker/scripts/tc_status.py --root . --all
```
### `resume <tc-id>`
1. Run:
```bash
python3 engineering/tc-tracker/scripts/tc_status.py --root . --tc-id <tc-id> --json
python3 engineering/skills/tc-tracker/scripts/tc_status.py --root . --tc-id <tc-id> --json
```
2. Display the handoff block prominently: `progress_summary`, `next_steps` (numbered), `blockers`, `key_context`.
3. Ask: "Resume <tc-id> and pick up at next step 1? (y/n)"
4. If yes, run an update to record the resumption:
```bash
python3 engineering/tc-tracker/scripts/tc_update.py --root . --tc-id <tc-id> \
python3 engineering/skills/tc-tracker/scripts/tc_update.py --root . --tc-id <tc-id> \
--note "Session resumed" --reason "session handoff"
```
5. Begin executing the first item in `next_steps`. Do NOT re-derive context — trust the handoff.
@ -103,7 +103,7 @@ Otherwise, parse `$ARGUMENTS` as `<subcommand> <rest>` and dispatch to the match
- "Test coverage status: none / partial / full"
5. Run:
```bash
python3 engineering/tc-tracker/scripts/tc_update.py --root . --tc-id <tc-id> \
python3 engineering/skills/tc-tracker/scripts/tc_update.py --root . --tc-id <tc-id> \
--set-status deployed --reason "Approved by <approver>" --note "Approval: <approver> — <notes>"
```
Then directly edit the `approval` block via a follow-up update if your script version supports it; otherwise instruct the user to record approval in `notes`.
@ -116,11 +116,11 @@ There is no automatic HTML export in this skill. Re-validate everything instead:
1. Read the registry.
2. For each record, run:
```bash
python3 engineering/tc-tracker/scripts/tc_validator.py --record <path> --json
python3 engineering/skills/tc-tracker/scripts/tc_validator.py --record <path> --json
```
3. Run:
```bash
python3 engineering/tc-tracker/scripts/tc_validator.py --registry docs/TC/tc_registry.json --json
python3 engineering/skills/tc-tracker/scripts/tc_validator.py --registry docs/TC/tc_registry.json --json
```
4. Report: total records validated, any errors, paths to anything invalid.
@ -128,7 +128,7 @@ There is no automatic HTML export in this skill. Re-validate everything instead:
Run the all-records summary:
```bash
python3 engineering/tc-tracker/scripts/tc_status.py --root . --all
python3 engineering/skills/tc-tracker/scripts/tc_status.py --root . --all
```
## Iron Rules

12
commands/tdd.md
View file

@ -24,13 +24,13 @@ Generate tests, analyze coverage, and validate test quality using the TDD Guide
```
## Scripts
- `engineering-team/tdd-guide/scripts/test_generator.py` — Test case generation (library module)
- `engineering-team/tdd-guide/scripts/coverage_analyzer.py` — Coverage analysis (library module)
- `engineering-team/tdd-guide/scripts/tdd_workflow.py` — TDD workflow orchestration (library module)
- `engineering-team/tdd-guide/scripts/fixture_generator.py` — Test fixture generation (library module)
- `engineering-team/tdd-guide/scripts/metrics_calculator.py` — TDD metrics calculation (library module)
- `engineering-team/skills/tdd-guide/scripts/test_generator.py` — Test case generation (library module)
- `engineering-team/skills/tdd-guide/scripts/coverage_analyzer.py` — Coverage analysis (library module)
- `engineering-team/skills/tdd-guide/scripts/tdd_workflow.py` — TDD workflow orchestration (library module)
- `engineering-team/skills/tdd-guide/scripts/fixture_generator.py` — Test fixture generation (library module)
- `engineering-team/skills/tdd-guide/scripts/metrics_calculator.py` — TDD metrics calculation (library module)
> **Note:** These scripts are library modules without CLI entry points. Import them in Python or use via the SKILL.md workflow guidance.
## Skill Reference
→ `engineering-team/tdd-guide/SKILL.md`
→ `engineering-team/skills/tdd-guide/SKILL.md`

8
commands/tech-debt.md
View file

@ -24,9 +24,9 @@ Scan codebases for technical debt, score severity, and generate prioritized reme
```
## Scripts
- `engineering/tech-debt-tracker/scripts/debt_scanner.py` — Scan for debt patterns (`debt_scanner.py <directory> [--format json] [--output file]`)
- `engineering/tech-debt-tracker/scripts/debt_prioritizer.py` — Prioritize debt backlog (`debt_prioritizer.py <inventory.json> [--framework cost_of_delay|wsjf|rice] [--format json]`)
- `engineering/tech-debt-tracker/scripts/debt_dashboard.py` — Generate debt dashboard (`debt_dashboard.py [files...] [--input-dir dir] [--period weekly|monthly|quarterly] [--format json]`)
- `engineering/skills/tech-debt-tracker/scripts/debt_scanner.py` — Scan for debt patterns (`debt_scanner.py <directory> [--format json] [--output file]`)
- `engineering/skills/tech-debt-tracker/scripts/debt_prioritizer.py` — Prioritize debt backlog (`debt_prioritizer.py <inventory.json> [--framework cost_of_delay|wsjf|rice] [--format json]`)
- `engineering/skills/tech-debt-tracker/scripts/debt_dashboard.py` — Generate debt dashboard (`debt_dashboard.py [files...] [--input-dir dir] [--period weekly|monthly|quarterly] [--format json]`)
## Skill Reference
→ `engineering/tech-debt-tracker/SKILL.md`
→ `engineering/skills/tech-debt-tracker/SKILL.md`

4
commands/user-story.md
View file

@ -37,7 +37,7 @@ Interactive mode prompts for feature context. For sprint planning, provide capac
```
## Scripts
- `product-team/agile-product-owner/scripts/user_story_generator.py` — User story generator (positional args: `sprint <capacity>`)
- `product-team/agile-product-owner/skills/agile-product-owner/scripts/user_story_generator.py` — User story generator (positional args: `sprint <capacity>`)
## Skill Reference
> `product-team/agile-product-owner/SKILL.md`
> `product-team/agile-product-owner/skills/agile-product-owner/SKILL.md`

16
commands/wiki-ingest.md
View file

@ -21,13 +21,13 @@ A typical ingest touches **5-15 wiki pages**. You (the user) are in the loop: th
## What happens
1. **Prep** — runs `scripts/ingest_source.py` to get title, preview, and suggested summary path
1. **Prep** — runs `engineering/llm-wiki/skills/llm-wiki/scripts/ingest_source.py` to get title, preview, and suggested summary path
2. **Read** — reads the source directly
3. **Discuss** — reports TL;DR, key claims, which pages will be touched, any contradictions
4. **Confirm** — waits for your go-ahead (or redirects)
5. **Write** — creates the source summary, updates 5-15 pages, flags contradictions
6. **Index** — runs `scripts/update_index.py` or edits `wiki/index.md` inline
7. **Log** — runs `scripts/append_log.py --op ingest --title "<title>"`
6. **Index** — runs `engineering/llm-wiki/skills/llm-wiki/scripts/update_index.py` or edits `wiki/index.md` inline
7. **Log** — runs `engineering/llm-wiki/skills/llm-wiki/scripts/append_log.py --op ingest --title "<title>"`
8. **Report** — bulleted wikilinks to every touched page
## Sub-agent
@ -36,9 +36,9 @@ This command dispatches the `wiki-ingestor` sub-agent for the heavy lifting. See
## Scripts
- `engineering/llm-wiki/scripts/ingest_source.py` — source prep (metadata + preview)
- `engineering/llm-wiki/scripts/update_index.py` — regenerate index
- `engineering/llm-wiki/scripts/append_log.py` — log the ingest
- `engineering/llm-wiki/skills/llm-wiki/scripts/ingest_source.py` — source prep (metadata + preview)
- `engineering/llm-wiki/skills/llm-wiki/scripts/update_index.py` — regenerate index
- `engineering/llm-wiki/skills/llm-wiki/scripts/append_log.py` — log the ingest
## Rules
@ -48,5 +48,5 @@ This command dispatches the `wiki-ingestor` sub-agent for the heavy lifting. See
## Skill Reference
→ `engineering/llm-wiki/SKILL.md`
→ `engineering/llm-wiki/references/ingest-workflow.md`
→ `engineering/llm-wiki/skills/llm-wiki/SKILL.md`
→ `engineering/llm-wiki/skills/llm-wiki/references/ingest-workflow.md`

4
commands/wiki-init.md
View file

@ -53,8 +53,8 @@ After init:
## Script
- `engineering/llm-wiki/scripts/init_vault.py`
- `engineering/llm-wiki/skills/llm-wiki/scripts/init_vault.py`
## Skill Reference
→ `engineering/llm-wiki/SKILL.md`
→ `engineering/llm-wiki/skills/llm-wiki/SKILL.md`

14
commands/wiki-lint.md
View file

@ -21,8 +21,8 @@ Run this weekly, after batch ingests, and always before sharing the wiki.
### Pass 1 — Mechanical (scripts)
- `scripts/lint_wiki.py` — orphans, broken links, stale pages, missing frontmatter, duplicate titles, log gap
- `scripts/graph_analyzer.py` — hubs, sinks, connected components, graph stats
- `engineering/llm-wiki/skills/llm-wiki/scripts/lint_wiki.py` — orphans, broken links, stale pages, missing frontmatter, duplicate titles, log gap
- `engineering/llm-wiki/skills/llm-wiki/scripts/graph_analyzer.py` — hubs, sinks, connected components, graph stats
### Pass 2 — Semantic (LLM reads and thinks)
@ -64,9 +64,9 @@ Dispatches the `wiki-linter` sub-agent. See `agents/wiki-linter.md`.
## Scripts
- `engineering/llm-wiki/scripts/lint_wiki.py`
- `engineering/llm-wiki/scripts/graph_analyzer.py`
- `engineering/llm-wiki/scripts/append_log.py`
- `engineering/llm-wiki/skills/llm-wiki/scripts/lint_wiki.py`
- `engineering/llm-wiki/skills/llm-wiki/scripts/graph_analyzer.py`
- `engineering/llm-wiki/skills/llm-wiki/scripts/append_log.py`
## Frequency
@ -79,5 +79,5 @@ Dispatches the `wiki-linter` sub-agent. See `agents/wiki-linter.md`.
## Skill Reference
→ `engineering/llm-wiki/SKILL.md`
→ `engineering/llm-wiki/references/lint-workflow.md`
→ `engineering/llm-wiki/skills/llm-wiki/SKILL.md`
→ `engineering/llm-wiki/skills/llm-wiki/references/lint-workflow.md`

2
commands/wiki-log.md
View file

@ -61,4 +61,4 @@ Filed back to comparisons/sae-vs-probing.md.
## Skill Reference
→ `engineering/llm-wiki/SKILL.md`
→ `engineering/llm-wiki/skills/llm-wiki/SKILL.md`

10
commands/wiki-query.md
View file

@ -22,7 +22,7 @@ Ask the wiki a question. The librarian reads `index.md` first, picks relevant pa
1. **Index-first read** — reads `wiki/index.md` to find relevant pages
2. **Drill-in** — reads 3-10 pages in full (synthesis + concepts + sources + entities)
3. **Follow links** — opportunistically follows wikilinks between pages
4. **Fallback search** — if the index isn't enough, runs `scripts/wiki_search.py` (BM25)
4. **Fallback search** — if the index isn't enough, runs `engineering/llm-wiki/skills/llm-wiki/scripts/wiki_search.py` (BM25)
5. **Synthesize** — composes a direct answer + supporting detail + inline `[[sources/xxx]]` citations + "Related pages" section
6. **Offer to file back** — asks whether to save this as a new wiki page (usually in `comparisons/` or `synthesis/`)
@ -43,8 +43,8 @@ This command dispatches the `wiki-librarian` sub-agent. See `agents/wiki-librari
## Scripts
- `engineering/llm-wiki/scripts/wiki_search.py` — BM25 fallback search
- `engineering/llm-wiki/scripts/append_log.py` — log filed answers
- `engineering/llm-wiki/skills/llm-wiki/scripts/wiki_search.py` — BM25 fallback search
- `engineering/llm-wiki/skills/llm-wiki/scripts/append_log.py` — log filed answers
## Rules
@ -54,5 +54,5 @@ This command dispatches the `wiki-librarian` sub-agent. See `agents/wiki-librari
## Skill Reference
→ `engineering/llm-wiki/SKILL.md`
→ `engineering/llm-wiki/references/query-workflow.md`
→ `engineering/llm-wiki/skills/llm-wiki/SKILL.md`
→ `engineering/llm-wiki/skills/llm-wiki/references/query-workflow.md`

6
compliance-os/skills/ai-act-readiness/SKILL.md
View file

@ -68,13 +68,13 @@ The EU AI Act compliance operator pressure-tests any AI system before EU deploym
```bash
# 1. Risk classification
python ../../ra-qm-team/skills/eu-ai-act-specialist/scripts/ai_system_risk_classifier.py systems.json
python ra-qm-team/skills/eu-ai-act-specialist/scripts/ai_system_risk_classifier.py systems.json
# 2. If high-risk: conformity assessment
python ../../ra-qm-team/skills/eu-ai-act-specialist/scripts/conformity_assessment_planner.py system.json
python ra-qm-team/skills/eu-ai-act-specialist/scripts/conformity_assessment_planner.py system.json
# 3. Per-role obligation matrix
python ../../ra-qm-team/skills/eu-ai-act-specialist/scripts/ai_act_obligation_tracker.py roles.json
python ra-qm-team/skills/eu-ai-act-specialist/scripts/ai_act_obligation_tracker.py roles.json
# 4. Cross-framework reuse (ISO 42001 etc.)
python ../../skills/compliance-os/scripts/cross_framework_mapper.py program.json

6
compliance-os/skills/aims-audit/SKILL.md
View file

@ -62,13 +62,13 @@ The ISO 42001 AIMS specialist pressure-tests any AI Management System work. Six
```bash
# 1. AIMS gap analysis
python ../../ra-qm-team/skills/iso42001-specialist/scripts/aims_gap_analyzer.py evidence.json
python ra-qm-team/skills/iso42001-specialist/scripts/aims_gap_analyzer.py evidence.json
# 2. AI risk register
python ../../ra-qm-team/skills/iso42001-specialist/scripts/ai_risk_register_builder.py risks.json
python ra-qm-team/skills/iso42001-specialist/scripts/ai_risk_register_builder.py risks.json
# 3. Internal audit plan
python ../../ra-qm-team/skills/iso42001-specialist/scripts/aims_audit_scheduler.py audit_scope.json
python ra-qm-team/skills/iso42001-specialist/scripts/aims_audit_scheduler.py audit_scope.json
# 4. Cross-framework reuse map (via compliance-os)
python ../../skills/compliance-os/scripts/cross_framework_mapper.py program.json

22
compliance-os/skills/compliance-os/SKILL.md
View file

@ -180,17 +180,17 @@ python scripts/evidence_pool_generator.py program.json
## Adjacent Skills
- `../../ra-qm-team/skills/iso42001-specialist/` — ISO 42001 deep-dive (paired with compliance-team-iso42001 plugin)
- `../../ra-qm-team/skills/eu-ai-act-specialist/` — EU AI Act deep-dive (paired with compliance-team-eu-ai-act plugin)
- `../../ra-qm-team/skills/information-security-manager-iso27001/` — ISO 27001 ISMS deep-dive
- `../../ra-qm-team/skills/quality-manager-qms-iso13485/` — ISO 13485 QMS deep-dive
- `../../ra-qm-team/skills/gdpr-dsgvo-expert/` — GDPR deep-dive
- `../../ra-qm-team/skills/soc2-compliance/` — SOC 2 deep-dive
- `../../ra-qm-team/skills/fda-consultant-specialist/` — FDA QSR deep-dive
- `../../ra-qm-team/skills/mdr-745-specialist/` — EU MDR 745 deep-dive
- `../../ra-qm-team/skills/risk-management-specialist/` — ISO 14971 deep-dive
- `../../c-level-advisor/chief-ai-officer-advisor/` — Executive AI risk decisions (build-vs-buy, model selection)
- `../../c-level-advisor/skills/general-counsel-advisor/` — Legal review for novel cases
- `ra-qm-team/skills/iso42001-specialist/` — ISO 42001 deep-dive (paired with compliance-team-iso42001 plugin)
- `ra-qm-team/skills/eu-ai-act-specialist/` — EU AI Act deep-dive (paired with compliance-team-eu-ai-act plugin)
- `ra-qm-team/skills/information-security-manager-iso27001/` — ISO 27001 ISMS deep-dive
- `ra-qm-team/skills/quality-manager-qms-iso13485/` — ISO 13485 QMS deep-dive
- `ra-qm-team/skills/gdpr-dsgvo-expert/` — GDPR deep-dive
- `ra-qm-team/skills/soc2-compliance/` — SOC 2 deep-dive
- `ra-qm-team/skills/fda-consultant-specialist/` — FDA QSR deep-dive
- `ra-qm-team/skills/mdr-745-specialist/` — EU MDR 745 deep-dive
- `ra-qm-team/skills/risk-management-specialist/` — ISO 14971 deep-dive
- `c-level-advisor/chief-ai-officer-advisor/` — Executive AI risk decisions (build-vs-buy, model selection)
- `c-level-advisor/skills/general-counsel-advisor/` — Legal review for novel cases
## References

2
compliance-os/skills/compliance-readiness/SKILL.md
View file

@ -129,7 +129,7 @@ python ../../skills/compliance-os/scripts/audit_simulator.py scope.json
- Agent: [`cs-compliance-officer`](../../agents/cs-compliance-officer.md)
- Skill: [`compliance-os`](../compliance-os/SKILL.md)
- Adjacent: `../../ra-qm-team/skills/iso42001-specialist/`, `../../ra-qm-team/skills/eu-ai-act-specialist/`, `../../ra-qm-team/skills/information-security-manager-iso27001/`, `../../ra-qm-team/skills/soc2-compliance/`, `../../ra-qm-team/skills/gdpr-dsgvo-expert/`
- Adjacent: `ra-qm-team/skills/iso42001-specialist/`, `ra-qm-team/skills/eu-ai-act-specialist/`, `ra-qm-team/skills/information-security-manager-iso27001/`, `ra-qm-team/skills/soc2-compliance/`, `ra-qm-team/skills/gdpr-dsgvo-expert/`
---

6
compliance-os/skills/fda-qsr-audit-prep/SKILL.md
View file

@ -69,13 +69,13 @@ The FDA QSR auditor pressure-tests any US medical-device QSR work. Six questions
```bash
# 1. QSR compliance posture
python ../../ra-qm-team/skills/fda-consultant-specialist/scripts/qsr_compliance_checker.py compliance_state.json
python ra-qm-team/skills/fda-consultant-specialist/scripts/qsr_compliance_checker.py compliance_state.json
# 2. FDA submission tracking (510(k) / PMA / IDE)
python ../../ra-qm-team/skills/fda-consultant-specialist/scripts/fda_submission_tracker.py submissions.json
python ra-qm-team/skills/fda-consultant-specialist/scripts/fda_submission_tracker.py submissions.json
# 3. HIPAA overlap (if connected device handles PHI)
python ../../ra-qm-team/skills/fda-consultant-specialist/scripts/hipaa_risk_assessment.py phi_inventory.json
python ra-qm-team/skills/fda-consultant-specialist/scripts/hipaa_risk_assessment.py phi_inventory.json
# 4. Mock FDA inspection
python ../../skills/compliance-os/scripts/audit_simulator.py fda_qsr_scope.json

6
compliance-os/skills/gdpr-audit-prep/SKILL.md
View file

@ -72,13 +72,13 @@ The GDPR DPO auditor pressure-tests any privacy compliance work. Six Article-cit
```bash
# 1. Compliance posture
python ../../ra-qm-team/skills/gdpr-dsgvo-expert/scripts/gdpr_compliance_checker.py compliance_state.json
python ra-qm-team/skills/gdpr-dsgvo-expert/scripts/gdpr_compliance_checker.py compliance_state.json
# 2. DPIA for high-risk activities
python ../../ra-qm-team/skills/gdpr-dsgvo-expert/scripts/dpia_generator.py processing_activity.json
python ra-qm-team/skills/gdpr-dsgvo-expert/scripts/dpia_generator.py processing_activity.json
# 3. DSAR workflow validation
python ../../ra-qm-team/skills/gdpr-dsgvo-expert/scripts/data_subject_rights_tracker.py dsar_log.json
python ra-qm-team/skills/gdpr-dsgvo-expert/scripts/data_subject_rights_tracker.py dsar_log.json
# 4. Cross-framework reuse with ISO 27001 + SOC 2 + ISO 42001
python ../../skills/compliance-os/scripts/cross_framework_mapper.py program.json

2
compliance-os/skills/iso13485-audit-prep/SKILL.md
View file

@ -69,7 +69,7 @@ The ISO 13485 QMS auditor pressure-tests any medical-device QMS work. Six tracea
```bash
# 1. Audit programme optimization
python ../../ra-qm-team/skills/qms-audit-expert/scripts/audit_schedule_optimizer.py audit_scope.json
python ra-qm-team/skills/qms-audit-expert/scripts/audit_schedule_optimizer.py audit_scope.json
# 2. Mock audit for readiness check
python ../../skills/compliance-os/scripts/audit_simulator.py iso13485_scope.json

2
compliance-os/skills/iso27001-audit-prep/SKILL.md
View file

@ -65,7 +65,7 @@ The ISO 27001 ISMS auditor pressure-tests any ISMS work. Six sample-driven quest
```bash
# 1. Audit programme planning
python ../../ra-qm-team/skills/isms-audit-expert/scripts/isms_audit_scheduler.py audit_scope.json
python ra-qm-team/skills/isms-audit-expert/scripts/isms_audit_scheduler.py audit_scope.json
# 2. Mock audit for readiness check
python ../../skills/compliance-os/scripts/audit_simulator.py iso27001_scope.json

6
compliance-os/skills/soc2-audit-prep/SKILL.md
View file

@ -68,13 +68,13 @@ The SOC 2 Type II auditor pressure-tests any SOC 2 work. Six observation-period-
```bash
# 1. Scoping + gap analysis (pre-observation)
python ../../ra-qm-team/skills/soc2-compliance/scripts/gap_analyzer.py current_state.json
python ra-qm-team/skills/soc2-compliance/scripts/gap_analyzer.py current_state.json
# 2. Control matrix with ISO 27001 cross-walk
python ../../ra-qm-team/skills/soc2-compliance/scripts/control_matrix_builder.py program.json
python ra-qm-team/skills/soc2-compliance/scripts/control_matrix_builder.py program.json
# 3. Continuous evidence tracking (during observation)
python ../../ra-qm-team/skills/soc2-compliance/scripts/evidence_tracker.py evidence_log.json
python ra-qm-team/skills/soc2-compliance/scripts/evidence_tracker.py evidence_log.json
# 4. Mock audit (pre-field-test month 10)
python ../../skills/compliance-os/scripts/audit_simulator.py soc2_scope.json

2
engineering/agenthub/skills/run/SKILL.md
View file

@ -66,7 +66,7 @@ If no `--eval` was provided, skip this step.
Run `/hub:spawn` with the session ID.
If `--template` was provided, use the template dispatch prompt from `references/agent-templates.md` instead of the default dispatch prompt. Pass the eval command, metric, and baseline to the template variables.
If `--template` was provided, use the template dispatch prompt from `../agenthub/references/agent-templates.md` instead of the default dispatch prompt. Pass the eval command, metric, and baseline to the template variables.
Launch all agents in a single message with multiple Agent tool calls (true parallelism).

2
engineering/agenthub/skills/spawn/SKILL.md
View file

@ -19,7 +19,7 @@ Spawn N subagents that work on the same task in parallel, each in an isolated gi
## Templates
When `--template <name>` is provided, use the dispatch prompt from `references/agent-templates.md` instead of the default prompt below. Available templates:
When `--template <name>` is provided, use the dispatch prompt from `../agenthub/references/agent-templates.md` instead of the default prompt below. Available templates:
| Template | Pattern | Use Case |
|----------|---------|----------|

Some files were not shown because too many files have changed in this diff Show more