diff --git a/agents/c-level/cs-cto-advisor.md b/agents/c-level/cs-cto-advisor.md index 6d723f70..5ea55e95 100644 --- a/agents/c-level/cs-cto-advisor.md +++ b/agents/c-level/cs-cto-advisor.md @@ -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 diff --git a/agents/engineering-team/cs-workspace-admin.md b/agents/engineering-team/cs-workspace-admin.md index c0b9a5e2..82381f8d 100644 --- a/agents/engineering-team/cs-workspace-admin.md +++ b/agents/engineering-team/cs-workspace-admin.md @@ -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) diff --git a/agents/engineering/cs-backend-engineer.md b/agents/engineering/cs-backend-engineer.md index d3579d27..5a6d6eff 100644 --- a/agents/engineering/cs-backend-engineer.md +++ b/agents/engineering/cs-backend-engineer.md @@ -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 diff --git a/agents/engineering/cs-fullstack-engineer.md b/agents/engineering/cs-fullstack-engineer.md index 94cb262e..69a49073 100644 --- a/agents/engineering/cs-fullstack-engineer.md +++ b/agents/engineering/cs-fullstack-engineer.md @@ -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 diff --git a/agents/engineering/cs-wiki-ingestor.md b/agents/engineering/cs-wiki-ingestor.md index 185f08ac..16aa1dbe 100644 --- a/agents/engineering/cs-wiki-ingestor.md +++ b/agents/engineering/cs-wiki-ingestor.md @@ -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 /scripts/ingest_source.py --vault . --source --json` to get the brief (title guess, word count, preview, suggested summary path, whether a summary already exists). diff --git a/agents/engineering/cs-wiki-librarian.md b/agents/engineering/cs-wiki-librarian.md index 7e2b7a2e..023681e7 100644 --- a/agents/engineering/cs-wiki-librarian.md +++ b/agents/engineering/cs-wiki-librarian.md @@ -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 /scripts/append_log.py --vault . --op create --title "" --detail "filed query response to "` diff --git a/agents/engineering/cs-wiki-linter.md b/agents/engineering/cs-wiki-linter.md index 19c45a7f..82d4f989 100644 --- a/agents/engineering/cs-wiki-linter.md +++ b/agents/engineering/cs-wiki-linter.md @@ -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) diff --git a/agents/finance/cs-financial-analyst.md b/agents/finance/cs-financial-analyst.md index b399ca66..d7956583 100644 --- a/agents/finance/cs-financial-analyst.md +++ b/agents/finance/cs-financial-analyst.md @@ -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 diff --git a/agents/marketing/cs-aeo.md b/agents/marketing/cs-aeo.md index 9e10e368..7b8b0d3a 100644 --- a/agents/marketing/cs-aeo.md +++ b/agents/marketing/cs-aeo.md @@ -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) --- diff --git a/agents/marketing/cs-content-creator.md b/agents/marketing/cs-content-creator.md index f03b7446..8a8942a1 100644 --- a/agents/marketing/cs-content-creator.md +++ b/agents/marketing/cs-content-creator.md @@ -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) diff --git a/agents/marketing/cs-demand-gen-specialist.md b/agents/marketing/cs-demand-gen-specialist.md index 0e91e395..e6bcf848 100644 --- a/agents/marketing/cs-demand-gen-specialist.md +++ b/agents/marketing/cs-demand-gen-specialist.md @@ -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) diff --git a/agents/marketing/cs-webinar-marketer.md b/agents/marketing/cs-webinar-marketer.md index 5ee4082e..0ce6274c 100644 --- a/agents/marketing/cs-webinar-marketer.md +++ b/agents/marketing/cs-webinar-marketer.md @@ -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 diff --git a/agents/product/cs-agile-product-owner.md b/agents/product/cs-agile-product-owner.md index 9fe28739..51c225ca 100644 --- a/agents/product/cs-agile-product-owner.md +++ b/agents/product/cs-agile-product-owner.md @@ -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) --- diff --git a/agents/product/cs-product-analyst.md b/agents/product/cs-product-analyst.md index d80dcb38..a54e8805 100644 --- a/agents/product/cs-product-analyst.md +++ b/agents/product/cs-product-analyst.md @@ -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. diff --git a/agents/product/cs-product-manager.md b/agents/product/cs-product-manager.md index b55013d2..a8e5774d 100644 --- a/agents/product/cs-product-manager.md +++ b/agents/product/cs-product-manager.md @@ -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) diff --git a/agents/product/cs-product-strategist.md b/agents/product/cs-product-strategist.md index a77ed228..86b1f228 100644 --- a/agents/product/cs-product-strategist.md +++ b/agents/product/cs-product-strategist.md @@ -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) diff --git a/agents/product/cs-ux-researcher.md b/agents/product/cs-ux-researcher.md index 27a3917a..830cb519 100644 --- a/agents/product/cs-ux-researcher.md +++ b/agents/product/cs-ux-researcher.md @@ -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) diff --git a/agents/project-management/cs-project-manager.md b/agents/project-management/cs-project-manager.md index db3c2f75..8a06df65 100644 --- a/agents/project-management/cs-project-manager.md +++ b/agents/project-management/cs-project-manager.md @@ -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) diff --git a/business-growth/skills/business-growth-skills/SKILL.md b/business-growth/skills/business-growth-skills/SKILL.md index 15f595f3..74bcd642 100644 --- a/business-growth/skills/business-growth-skills/SKILL.md +++ b/business-growth/skills/business-growth-skills/SKILL.md @@ -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 diff --git a/business-growth/skills/sales-engineer/SKILL.md b/business-growth/skills/sales-engineer/SKILL.md index dc1e5fad..912f6d2d 100644 --- a/business-growth/skills/sales-engineer/SKILL.md +++ b/business-growth/skills/sales-engineer/SKILL.md @@ -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/` --- diff --git a/c-level-advisor/c-level-agents/agents/cs-caio-advisor.md b/c-level-advisor/c-level-agents/agents/cs-caio-advisor.md index 080cf5ca..7a0cc9be 100644 --- a/c-level-advisor/c-level-agents/agents/cs-caio-advisor.md +++ b/c-level-advisor/c-level-agents/agents/cs-caio-advisor.md @@ -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 diff --git a/c-level-advisor/c-level-agents/agents/cs-cco-advisor.md b/c-level-advisor/c-level-agents/agents/cs-cco-advisor.md index c6ccfa9c..7971f5fc 100644 --- a/c-level-advisor/c-level-agents/agents/cs-cco-advisor.md +++ b/c-level-advisor/c-level-agents/agents/cs-cco-advisor.md @@ -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 diff --git a/c-level-advisor/c-level-agents/agents/cs-cdo-advisor.md b/c-level-advisor/c-level-agents/agents/cs-cdo-advisor.md index 9cca3b6a..0ce1b0ce 100644 --- a/c-level-advisor/c-level-agents/agents/cs-cdo-advisor.md +++ b/c-level-advisor/c-level-agents/agents/cs-cdo-advisor.md @@ -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 diff --git a/c-level-advisor/c-level-agents/agents/cs-cfo-advisor.md b/c-level-advisor/c-level-agents/agents/cs-cfo-advisor.md index 8fb8d025..d5953347 100644 --- a/c-level-advisor/c-level-agents/agents/cs-cfo-advisor.md +++ b/c-level-advisor/c-level-agents/agents/cs-cfo-advisor.md @@ -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 diff --git a/c-level-advisor/c-level-agents/agents/cs-chief-of-staff.md b/c-level-advisor/c-level-agents/agents/cs-chief-of-staff.md index d60ac0aa..3149fc62 100644 --- a/c-level-advisor/c-level-agents/agents/cs-chief-of-staff.md +++ b/c-level-advisor/c-level-agents/agents/cs-chief-of-staff.md @@ -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 diff --git a/c-level-advisor/c-level-agents/agents/cs-chro-advisor.md b/c-level-advisor/c-level-agents/agents/cs-chro-advisor.md index fbc36e91..0776beb4 100644 --- a/c-level-advisor/c-level-agents/agents/cs-chro-advisor.md +++ b/c-level-advisor/c-level-agents/agents/cs-chro-advisor.md @@ -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 diff --git a/c-level-advisor/c-level-agents/agents/cs-ciso-advisor.md b/c-level-advisor/c-level-agents/agents/cs-ciso-advisor.md index d4ae4fed..b3ed0303 100644 --- a/c-level-advisor/c-level-agents/agents/cs-ciso-advisor.md +++ b/c-level-advisor/c-level-agents/agents/cs-ciso-advisor.md @@ -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 diff --git a/c-level-advisor/c-level-agents/agents/cs-cmo-advisor.md b/c-level-advisor/c-level-agents/agents/cs-cmo-advisor.md index ea6f4d26..0b8d6f3e 100644 --- a/c-level-advisor/c-level-agents/agents/cs-cmo-advisor.md +++ b/c-level-advisor/c-level-agents/agents/cs-cmo-advisor.md @@ -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 diff --git a/c-level-advisor/c-level-agents/agents/cs-coo-advisor.md b/c-level-advisor/c-level-agents/agents/cs-coo-advisor.md index 9b64fae1..443116d6 100644 --- a/c-level-advisor/c-level-agents/agents/cs-coo-advisor.md +++ b/c-level-advisor/c-level-agents/agents/cs-coo-advisor.md @@ -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 diff --git a/c-level-advisor/c-level-agents/agents/cs-cpo-advisor.md b/c-level-advisor/c-level-agents/agents/cs-cpo-advisor.md index 9e3aa06d..e2116d57 100644 --- a/c-level-advisor/c-level-agents/agents/cs-cpo-advisor.md +++ b/c-level-advisor/c-level-agents/agents/cs-cpo-advisor.md @@ -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 diff --git a/c-level-advisor/c-level-agents/agents/cs-cro-advisor.md b/c-level-advisor/c-level-agents/agents/cs-cro-advisor.md index d191d8ec..0a16b2e5 100644 --- a/c-level-advisor/c-level-agents/agents/cs-cro-advisor.md +++ b/c-level-advisor/c-level-agents/agents/cs-cro-advisor.md @@ -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 diff --git a/c-level-advisor/c-level-agents/agents/cs-general-counsel-advisor.md b/c-level-advisor/c-level-agents/agents/cs-general-counsel-advisor.md index 36507c69..bc90a4e9 100644 --- a/c-level-advisor/c-level-agents/agents/cs-general-counsel-advisor.md +++ b/c-level-advisor/c-level-agents/agents/cs-general-counsel-advisor.md @@ -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 diff --git a/c-level-advisor/c-level-agents/agents/cs-vpe-advisor.md b/c-level-advisor/c-level-agents/agents/cs-vpe-advisor.md index 1d65ae86..96bdcf04 100644 --- a/c-level-advisor/c-level-agents/agents/cs-vpe-advisor.md +++ b/c-level-advisor/c-level-agents/agents/cs-vpe-advisor.md @@ -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 diff --git a/c-level-advisor/c-level-agents/skills/c-level-agents/SKILL.md b/c-level-advisor/c-level-agents/skills/c-level-agents/SKILL.md index 4972955b..3934054e 100644 --- a/c-level-advisor/c-level-agents/skills/c-level-agents/SKILL.md +++ b/c-level-advisor/c-level-agents/skills/c-level-agents/SKILL.md @@ -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 diff --git a/c-level-advisor/c-level-agents/skills/cpo-review/SKILL.md b/c-level-advisor/c-level-agents/skills/cpo-review/SKILL.md index c8613c21..ec66bed5 100644 --- a/c-level-advisor/c-level-agents/skills/cpo-review/SKILL.md +++ b/c-level-advisor/c-level-agents/skills/cpo-review/SKILL.md @@ -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/` --- diff --git a/c-level-advisor/chief-ai-officer-advisor/skills/chief-ai-officer-advisor/SKILL.md b/c-level-advisor/chief-ai-officer-advisor/skills/chief-ai-officer-advisor/SKILL.md index 38b1bb0c..349a7d43 100644 --- a/c-level-advisor/chief-ai-officer-advisor/skills/chief-ai-officer-advisor/SKILL.md +++ b/c-level-advisor/chief-ai-officer-advisor/skills/chief-ai-officer-advisor/SKILL.md @@ -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 diff --git a/c-level-advisor/chief-customer-officer-advisor/skills/chief-customer-officer-advisor/SKILL.md b/c-level-advisor/chief-customer-officer-advisor/skills/chief-customer-officer-advisor/SKILL.md index 76f581d4..1ae14b1b 100644 --- a/c-level-advisor/chief-customer-officer-advisor/skills/chief-customer-officer-advisor/SKILL.md +++ b/c-level-advisor/chief-customer-officer-advisor/skills/chief-customer-officer-advisor/SKILL.md @@ -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 diff --git a/c-level-advisor/chief-data-officer-advisor/skills/chief-data-officer-advisor/SKILL.md b/c-level-advisor/chief-data-officer-advisor/skills/chief-data-officer-advisor/SKILL.md index 6e049636..365a66ae 100644 --- a/c-level-advisor/chief-data-officer-advisor/skills/chief-data-officer-advisor/SKILL.md +++ b/c-level-advisor/chief-data-officer-advisor/skills/chief-data-officer-advisor/SKILL.md @@ -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 diff --git a/c-level-advisor/executive-mentor/skills/executive-mentor/SKILL.md b/c-level-advisor/executive-mentor/skills/executive-mentor/SKILL.md index 8c54885b..ec8a3d3d 100644 --- a/c-level-advisor/executive-mentor/skills/executive-mentor/SKILL.md +++ b/c-level-advisor/executive-mentor/skills/executive-mentor/SKILL.md @@ -71,19 +71,19 @@ This isn't therapy. It's preparation. ## Commands in Detail ### `/em:challenge ` -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 ` -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 ` -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 ` -"$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 ` -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 diff --git a/c-level-advisor/executive-mentor/skills/hard-call/SKILL.md b/c-level-advisor/executive-mentor/skills/hard-call/SKILL.md index 3e827e7f..bf99009a 100644 --- a/c-level-advisor/executive-mentor/skills/hard-call/SKILL.md +++ b/c-level-advisor/executive-mentor/skills/hard-call/SKILL.md @@ -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) diff --git a/c-level-advisor/general-counsel-advisor/skills/general-counsel-advisor/SKILL.md b/c-level-advisor/general-counsel-advisor/skills/general-counsel-advisor/SKILL.md index 9f562b23..1d1cef3d 100644 --- a/c-level-advisor/general-counsel-advisor/skills/general-counsel-advisor/SKILL.md +++ b/c-level-advisor/general-counsel-advisor/skills/general-counsel-advisor/SKILL.md @@ -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 diff --git a/c-level-advisor/skills/board-meeting/SKILL.md b/c-level-advisor/skills/board-meeting/SKILL.md index 1b1702c3..ee85fa4b 100644 --- a/c-level-advisor/skills/board-meeting/SKILL.md +++ b/c-level-advisor/skills/board-meeting/SKILL.md @@ -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 diff --git a/c-level-advisor/skills/c-level-skills/SKILL.md b/c-level-advisor/skills/c-level-skills/SKILL.md index cc05f631..5deb724d 100644 --- a/c-level-advisor/skills/c-level-skills/SKILL.md +++ b/c-level-advisor/skills/c-level-skills/SKILL.md @@ -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 diff --git a/c-level-advisor/skills/ceo-advisor/SKILL.md b/c-level-advisor/skills/ceo-advisor/SKILL.md index 6396c197..4fbe8eb3 100644 --- a/c-level-advisor/skills/ceo-advisor/SKILL.md +++ b/c-level-advisor/skills/ceo-advisor/SKILL.md @@ -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 diff --git a/c-level-advisor/skills/cfo-advisor/SKILL.md b/c-level-advisor/skills/cfo-advisor/SKILL.md index be2397ef..c4e4492a 100644 --- a/c-level-advisor/skills/cfo-advisor/SKILL.md +++ b/c-level-advisor/skills/cfo-advisor/SKILL.md @@ -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 diff --git a/c-level-advisor/skills/chief-ai-officer-advisor/SKILL.md b/c-level-advisor/skills/chief-ai-officer-advisor/SKILL.md index 38b1bb0c..349a7d43 100644 --- a/c-level-advisor/skills/chief-ai-officer-advisor/SKILL.md +++ b/c-level-advisor/skills/chief-ai-officer-advisor/SKILL.md @@ -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 diff --git a/c-level-advisor/skills/chief-customer-officer-advisor/SKILL.md b/c-level-advisor/skills/chief-customer-officer-advisor/SKILL.md index 76f581d4..1ae14b1b 100644 --- a/c-level-advisor/skills/chief-customer-officer-advisor/SKILL.md +++ b/c-level-advisor/skills/chief-customer-officer-advisor/SKILL.md @@ -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 diff --git a/c-level-advisor/skills/chief-data-officer-advisor/SKILL.md b/c-level-advisor/skills/chief-data-officer-advisor/SKILL.md index 6e049636..365a66ae 100644 --- a/c-level-advisor/skills/chief-data-officer-advisor/SKILL.md +++ b/c-level-advisor/skills/chief-data-officer-advisor/SKILL.md @@ -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 diff --git a/c-level-advisor/skills/chief-of-staff/SKILL.md b/c-level-advisor/skills/chief-of-staff/SKILL.md index d4b77e41..2e0bc135 100644 --- a/c-level-advisor/skills/chief-of-staff/SKILL.md +++ b/c-level-advisor/skills/chief-of-staff/SKILL.md @@ -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 diff --git a/c-level-advisor/skills/chro-advisor/SKILL.md b/c-level-advisor/skills/chro-advisor/SKILL.md index a846122d..e522976b 100644 --- a/c-level-advisor/skills/chro-advisor/SKILL.md +++ b/c-level-advisor/skills/chro-advisor/SKILL.md @@ -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 diff --git a/c-level-advisor/skills/ciso-advisor/SKILL.md b/c-level-advisor/skills/ciso-advisor/SKILL.md index ef7d035c..fd3d3b19 100644 --- a/c-level-advisor/skills/ciso-advisor/SKILL.md +++ b/c-level-advisor/skills/ciso-advisor/SKILL.md @@ -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 diff --git a/c-level-advisor/skills/cmo-advisor/SKILL.md b/c-level-advisor/skills/cmo-advisor/SKILL.md index f8fc3298..2582531e 100644 --- a/c-level-advisor/skills/cmo-advisor/SKILL.md +++ b/c-level-advisor/skills/cmo-advisor/SKILL.md @@ -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 diff --git a/c-level-advisor/skills/coo-advisor/SKILL.md b/c-level-advisor/skills/coo-advisor/SKILL.md index 26d76131..6f1f855c 100644 --- a/c-level-advisor/skills/coo-advisor/SKILL.md +++ b/c-level-advisor/skills/coo-advisor/SKILL.md @@ -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 diff --git a/c-level-advisor/skills/cpo-advisor/SKILL.md b/c-level-advisor/skills/cpo-advisor/SKILL.md index d7456a4f..0b159f9d 100644 --- a/c-level-advisor/skills/cpo-advisor/SKILL.md +++ b/c-level-advisor/skills/cpo-advisor/SKILL.md @@ -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 diff --git a/c-level-advisor/skills/cro-advisor/SKILL.md b/c-level-advisor/skills/cro-advisor/SKILL.md index e52a3786..bd314059 100644 --- a/c-level-advisor/skills/cro-advisor/SKILL.md +++ b/c-level-advisor/skills/cro-advisor/SKILL.md @@ -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 diff --git a/c-level-advisor/skills/cto-advisor/SKILL.md b/c-level-advisor/skills/cto-advisor/SKILL.md index e53d04f8..d42356a5 100644 --- a/c-level-advisor/skills/cto-advisor/SKILL.md +++ b/c-level-advisor/skills/cto-advisor/SKILL.md @@ -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 diff --git a/c-level-advisor/skills/general-counsel-advisor/SKILL.md b/c-level-advisor/skills/general-counsel-advisor/SKILL.md index 9f562b23..1d1cef3d 100644 --- a/c-level-advisor/skills/general-counsel-advisor/SKILL.md +++ b/c-level-advisor/skills/general-counsel-advisor/SKILL.md @@ -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 diff --git a/c-level-advisor/skills/vpe-advisor/SKILL.md b/c-level-advisor/skills/vpe-advisor/SKILL.md index 3319a2f9..7792c1a2 100644 --- a/c-level-advisor/skills/vpe-advisor/SKILL.md +++ b/c-level-advisor/skills/vpe-advisor/SKILL.md @@ -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 diff --git a/c-level-advisor/vpe-advisor/skills/vpe-advisor/SKILL.md b/c-level-advisor/vpe-advisor/skills/vpe-advisor/SKILL.md index 3319a2f9..7792c1a2 100644 --- a/c-level-advisor/vpe-advisor/skills/vpe-advisor/SKILL.md +++ b/c-level-advisor/vpe-advisor/skills/vpe-advisor/SKILL.md @@ -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 diff --git a/commands/a11y-audit.md b/commands/a11y-audit.md index dbafa25f..9a8ff7e0 100644 --- a/commands/a11y-audit.md +++ b/commands/a11y-audit.md @@ -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` diff --git a/commands/changelog.md b/commands/changelog.md index e9b04f22..d7978893 100644 --- a/commands/changelog.md +++ b/commands/changelog.md @@ -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` diff --git a/commands/code-to-prd.md b/commands/code-to-prd.md index 1bace0d0..ac6f88c4 100644 --- a/commands/code-to-prd.md +++ b/commands/code-to-prd.md @@ -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` diff --git a/commands/competitive-matrix.md b/commands/competitive-matrix.md index a60466c4..3e9122af 100644 --- a/commands/competitive-matrix.md +++ b/commands/competitive-matrix.md @@ -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` diff --git a/commands/cs-aeo.md b/commands/cs-aeo.md index b67c5d31..ec9e2d63 100644 --- a/commands/cs-aeo.md +++ b/commands/cs-aeo.md @@ -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) diff --git a/commands/cs-webinar.md b/commands/cs-webinar.md index d05cc99e..d1ed5118 100644 --- a/commands/cs-webinar.md +++ b/commands/cs-webinar.md @@ -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 diff --git a/commands/financial-health.md b/commands/financial-health.md index 10a4e1fc..f39d366f 100644 --- a/commands/financial-health.md +++ b/commands/financial-health.md @@ -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) diff --git a/commands/google-workspace.md b/commands/google-workspace.md index 704ef5c4..02c18ebf 100644 --- a/commands/google-workspace.md +++ b/commands/google-workspace.md @@ -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 ] [--json] -python3 engineering-team/google-workspace-cli/scripts/gws_recipe_runner.py --search [--json] -python3 engineering-team/google-workspace-cli/scripts/gws_recipe_runner.py --describe -python3 engineering-team/google-workspace-cli/scripts/gws_recipe_runner.py --run [--dry-run] +python3 engineering-team/google-workspace-cli/skills/google-workspace-cli/scripts/gws_recipe_runner.py --list [--persona ] [--json] +python3 engineering-team/google-workspace-cli/skills/google-workspace-cli/scripts/gws_recipe_runner.py --search [--json] +python3 engineering-team/google-workspace-cli/skills/google-workspace-cli/scripts/gws_recipe_runner.py --describe +python3 engineering-team/google-workspace-cli/skills/google-workspace-cli/scripts/gws_recipe_runner.py --run [--dry-run] ``` ### analyze Parse, filter, and aggregate JSON output from any gws command. ```bash -gws --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 --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) diff --git a/commands/karpathy-check.md b/commands/karpathy-check.md index cb060b0d..a2262dd5 100644 --- a/commands/karpathy-check.md +++ b/commands/karpathy-check.md @@ -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` diff --git a/commands/okr.md b/commands/okr.md index 5d5f9105..f17bec33 100644 --- a/commands/okr.md +++ b/commands/okr.md @@ -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 (` [--teams "A,B,C"] [--contribution 0.3] [--json]`) +- `product-team/skills/product-strategist/scripts/okr_cascade_generator.py` — OKR cascade generator (` [--teams "A,B,C"] [--contribution 0.3] [--json]`) ## Skill Reference -> `product-team/product-strategist/SKILL.md` +> `product-team/skills/product-strategist/SKILL.md` diff --git a/commands/persona.md b/commands/persona.md index c37b1e00..fb9a1b75 100644 --- a/commands/persona.md +++ b/commands/persona.md @@ -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` diff --git a/commands/pipeline.md b/commands/pipeline.md index 727f8688..2319666e 100644 --- a/commands/pipeline.md +++ b/commands/pipeline.md @@ -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 `, `--format text|json`) -- `engineering/ci-cd-pipeline-builder/scripts/pipeline_generator.py` — Generate pipeline YAML (`--platform github|gitlab`, `--repo `, `--input `, `--output `) +- `engineering/skills/ci-cd-pipeline-builder/scripts/stack_detector.py` — Detect stack and tooling (`--repo `, `--format text|json`) +- `engineering/skills/ci-cd-pipeline-builder/scripts/pipeline_generator.py` — Generate pipeline YAML (`--platform github|gitlab`, `--repo `, `--input `, `--output `) ## Skill Reference -→ `engineering/ci-cd-pipeline-builder/SKILL.md` +→ `engineering/skills/ci-cd-pipeline-builder/SKILL.md` diff --git a/commands/plugin-audit.md b/commands/plugin-audit.md index 04c3573a..f68e44c8 100644 --- a/commands/plugin-audit.md +++ b/commands/plugin-audit.md @@ -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` | diff --git a/commands/prd.md b/commands/prd.md index 2c005423..cdb35dd2 100644 --- a/commands/prd.md +++ b/commands/prd.md @@ -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` diff --git a/commands/project-health.md b/commands/project-health.md index 9bc4d4cc..34c1d2b8 100644 --- a/commands/project-health.md +++ b/commands/project-health.md @@ -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 (` [--format text|json]`) -- `project-management/senior-pm/scripts/risk_matrix_analyzer.py` — Risk matrix analyzer (` [--format text|json]`) +- `project-management/skills/senior-pm/scripts/project_health_dashboard.py` — Health dashboard (` [--format text|json]`) +- `project-management/skills/senior-pm/scripts/risk_matrix_analyzer.py` — Risk matrix analyzer (` [--format text|json]`) ## Skill Reference -> `project-management/senior-pm/SKILL.md` +> `project-management/skills/senior-pm/SKILL.md` diff --git a/commands/retro.md b/commands/retro.md index c7656625..52c67471 100644 --- a/commands/retro.md +++ b/commands/retro.md @@ -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 (` [--format text|json]`) +- `project-management/skills/scrum-master/scripts/retrospective_analyzer.py` — Retrospective analyzer (` [--format text|json]`) ## Skill Reference -> `project-management/scrum-master/SKILL.md` +> `project-management/skills/scrum-master/SKILL.md` diff --git a/commands/rice.md b/commands/rice.md index 726e0f91..93390ea0 100644 --- a/commands/rice.md +++ b/commands/rice.md @@ -33,7 +33,7 @@ Mobile app,20000,3,0.5,13 ``` ## Scripts -- `product-team/product-manager-toolkit/scripts/rice_prioritizer.py` — RICE prioritizer (` [--capacity N] [--output text|json|csv]`) +- `product-team/skills/product-manager-toolkit/scripts/rice_prioritizer.py` — RICE prioritizer (` [--capacity N] [--output text|json|csv]`) ## Skill Reference -> `product-team/product-manager-toolkit/SKILL.md` +> `product-team/skills/product-manager-toolkit/SKILL.md` diff --git a/commands/saas-health.md b/commands/saas-health.md index a5ac6e49..58ed3a29 100644 --- a/commands/saas-health.md +++ b/commands/saas-health.md @@ -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) diff --git a/commands/seo-auditor.md b/commands/seo-auditor.md index 167a3048..6f1cfbbb 100644 --- a/commands/seo-auditor.md +++ b/commands/seo-auditor.md @@ -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 | diff --git a/commands/sprint-health.md b/commands/sprint-health.md index 76708e75..ce39bff3 100644 --- a/commands/sprint-health.md +++ b/commands/sprint-health.md @@ -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 (` [--format text|json]`) -- `project-management/scrum-master/scripts/velocity_analyzer.py` — Velocity analyzer (` [--format text|json]`) +- `project-management/skills/scrum-master/scripts/sprint_health_scorer.py` — Sprint health scorer (` [--format text|json]`) +- `project-management/skills/scrum-master/scripts/velocity_analyzer.py` — Velocity analyzer (` [--format text|json]`) ## Skill Reference -> `project-management/scrum-master/SKILL.md` +> `project-management/skills/scrum-master/SKILL.md` diff --git a/commands/sprint-plan.md b/commands/sprint-plan.md index a504d239..0355d2ee 100644 --- a/commands/sprint-plan.md +++ b/commands/sprint-plan.md @@ -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` diff --git a/commands/tc.md b/commands/tc.md index e5c0cbc6..85e034ed 100644 --- a/commands/tc.md +++ b/commands/tc.md @@ -28,7 +28,7 @@ Otherwise, parse `$ARGUMENTS` as ` ` 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 ` as the next step. @@ -44,7 +44,7 @@ Otherwise, parse `$ARGUMENTS` as ` ` 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 "" --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 diff --git a/commands/tdd.md b/commands/tdd.md index 9eb41c62..d7b23ee9 100644 --- a/commands/tdd.md +++ b/commands/tdd.md @@ -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` diff --git a/commands/tech-debt.md b/commands/tech-debt.md index 042300aa..db153ef7 100644 --- a/commands/tech-debt.md +++ b/commands/tech-debt.md @@ -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` diff --git a/commands/user-story.md b/commands/user-story.md index 4a4d97e8..37cf215c 100644 --- a/commands/user-story.md +++ b/commands/user-story.md @@ -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` diff --git a/commands/wiki-ingest.md b/commands/wiki-ingest.md index e640ca2f..92de1198 100644 --- a/commands/wiki-ingest.md +++ b/commands/wiki-ingest.md @@ -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` diff --git a/commands/wiki-init.md b/commands/wiki-init.md index e62f9575..3859f540 100644 --- a/commands/wiki-init.md +++ b/commands/wiki-init.md @@ -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` diff --git a/commands/wiki-lint.md b/commands/wiki-lint.md index 1822a2f8..27a5e3db 100644 --- a/commands/wiki-lint.md +++ b/commands/wiki-lint.md @@ -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` diff --git a/commands/wiki-log.md b/commands/wiki-log.md index 404c38c4..575c626f 100644 --- a/commands/wiki-log.md +++ b/commands/wiki-log.md @@ -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` diff --git a/commands/wiki-query.md b/commands/wiki-query.md index d209dc52..1e485f69 100644 --- a/commands/wiki-query.md +++ b/commands/wiki-query.md @@ -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` diff --git a/compliance-os/skills/ai-act-readiness/SKILL.md b/compliance-os/skills/ai-act-readiness/SKILL.md index 423ac418..18e8c4cf 100644 --- a/compliance-os/skills/ai-act-readiness/SKILL.md +++ b/compliance-os/skills/ai-act-readiness/SKILL.md @@ -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 diff --git a/compliance-os/skills/aims-audit/SKILL.md b/compliance-os/skills/aims-audit/SKILL.md index e8ea82ba..4b75644c 100644 --- a/compliance-os/skills/aims-audit/SKILL.md +++ b/compliance-os/skills/aims-audit/SKILL.md @@ -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 diff --git a/compliance-os/skills/compliance-os/SKILL.md b/compliance-os/skills/compliance-os/SKILL.md index a61fb6ca..1b510c5e 100644 --- a/compliance-os/skills/compliance-os/SKILL.md +++ b/compliance-os/skills/compliance-os/SKILL.md @@ -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 diff --git a/compliance-os/skills/compliance-readiness/SKILL.md b/compliance-os/skills/compliance-readiness/SKILL.md index f347c316..7675e7a8 100644 --- a/compliance-os/skills/compliance-readiness/SKILL.md +++ b/compliance-os/skills/compliance-readiness/SKILL.md @@ -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/` --- diff --git a/compliance-os/skills/fda-qsr-audit-prep/SKILL.md b/compliance-os/skills/fda-qsr-audit-prep/SKILL.md index 2acd01be..6737d65c 100644 --- a/compliance-os/skills/fda-qsr-audit-prep/SKILL.md +++ b/compliance-os/skills/fda-qsr-audit-prep/SKILL.md @@ -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 diff --git a/compliance-os/skills/gdpr-audit-prep/SKILL.md b/compliance-os/skills/gdpr-audit-prep/SKILL.md index 525ad620..675fe8ad 100644 --- a/compliance-os/skills/gdpr-audit-prep/SKILL.md +++ b/compliance-os/skills/gdpr-audit-prep/SKILL.md @@ -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 diff --git a/compliance-os/skills/iso13485-audit-prep/SKILL.md b/compliance-os/skills/iso13485-audit-prep/SKILL.md index 8008fe38..33da4a63 100644 --- a/compliance-os/skills/iso13485-audit-prep/SKILL.md +++ b/compliance-os/skills/iso13485-audit-prep/SKILL.md @@ -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 diff --git a/compliance-os/skills/iso27001-audit-prep/SKILL.md b/compliance-os/skills/iso27001-audit-prep/SKILL.md index 642a90df..35f3400b 100644 --- a/compliance-os/skills/iso27001-audit-prep/SKILL.md +++ b/compliance-os/skills/iso27001-audit-prep/SKILL.md @@ -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 diff --git a/compliance-os/skills/soc2-audit-prep/SKILL.md b/compliance-os/skills/soc2-audit-prep/SKILL.md index 74c6b91a..a4080ac2 100644 --- a/compliance-os/skills/soc2-audit-prep/SKILL.md +++ b/compliance-os/skills/soc2-audit-prep/SKILL.md @@ -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 diff --git a/engineering/agenthub/skills/run/SKILL.md b/engineering/agenthub/skills/run/SKILL.md index f6235a86..1590c68d 100644 --- a/engineering/agenthub/skills/run/SKILL.md +++ b/engineering/agenthub/skills/run/SKILL.md @@ -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). diff --git a/engineering/agenthub/skills/spawn/SKILL.md b/engineering/agenthub/skills/spawn/SKILL.md index a95061a2..beb87b6e 100644 --- a/engineering/agenthub/skills/spawn/SKILL.md +++ b/engineering/agenthub/skills/spawn/SKILL.md @@ -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 | |----------|---------|----------| diff --git a/engineering/claude-coach/agents/cs-claude-coach.md b/engineering/claude-coach/agents/cs-claude-coach.md index b02469d7..ae67910a 100644 --- a/engineering/claude-coach/agents/cs-claude-coach.md +++ b/engineering/claude-coach/agents/cs-claude-coach.md @@ -28,7 +28,7 @@ You are the persona behind the `claude-coach` skill. Your job is to teach the us ## When to invoke -Activate on first explicit request to learn Claude ("coach me", "make me a power user", "Claude cheat codes"). Stay on for the remainder of the conversation. On every subsequent turn, run the 5-gate decision tree from `references/coaching-rules.md` before deciding whether to surface a tip. +Activate on first explicit request to learn Claude ("coach me", "make me a power user", "Claude cheat codes"). Stay on for the remainder of the conversation. On every subsequent turn, run the 5-gate decision tree from `skills/claude-coach/references/coaching-rules.md` before deciding whether to surface a tip. ## On-demand modes diff --git a/engineering/claude-coach/commands/cs-claude-coach.md b/engineering/claude-coach/commands/cs-claude-coach.md index 78f9cf3c..45d1b317 100644 --- a/engineering/claude-coach/commands/cs-claude-coach.md +++ b/engineering/claude-coach/commands/cs-claude-coach.md @@ -17,7 +17,7 @@ Activates the `claude-coach` skill. From this point on, the conversation gains: 2. Otherwise, ask exactly one question: **"What are your top 2-3 use cases for Claude?"** and wait. 3. Load `engineering/claude-coach/skills/claude-coach/references/cheat-codes.md`, rank techniques against the stated use cases, and present the top 5-7 with one-line explanations and one concrete example each. 4. End with: *"I'll watch your prompts going forward and surface tips when I spot an easy win — max one per response. Ask me 'rate that prompt' anytime for direct feedback."* -5. Stay active for the rest of the conversation. On every subsequent turn, run the 5-gate decision tree from `references/coaching-rules.md` before deciding whether to surface a tip. +5. Stay active for the rest of the conversation. On every subsequent turn, run the 5-gate decision tree from `skills/claude-coach/references/coaching-rules.md` before deciding whether to surface a tip. ## Examples diff --git a/engineering/karpathy-coder/commands/karpathy-check.md b/engineering/karpathy-coder/commands/karpathy-check.md index cb060b0d..4c4a3ada 100644 --- a/engineering/karpathy-coder/commands/karpathy-check.md +++ b/engineering/karpathy-coder/commands/karpathy-check.md @@ -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):** `skills/karpathy-coder/scripts/complexity_checker.py` on all changed files — detects over-engineering, premature abstractions, deep nesting, long functions +2. **Principle #3 (Surgical):** `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` diff --git a/engineering/llm-wiki/agents/wiki-ingestor.md b/engineering/llm-wiki/agents/wiki-ingestor.md index 0df48677..cfb4e93f 100644 --- a/engineering/llm-wiki/agents/wiki-ingestor.md +++ b/engineering/llm-wiki/agents/wiki-ingestor.md @@ -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 `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). diff --git a/engineering/llm-wiki/agents/wiki-librarian.md b/engineering/llm-wiki/agents/wiki-librarian.md index 1b300cd3..14d259a2 100644 --- a/engineering/llm-wiki/agents/wiki-librarian.md +++ b/engineering/llm-wiki/agents/wiki-librarian.md @@ -23,7 +23,7 @@ You are spawned **per-query**, not as a long-running agent. ## Workflow -Follow `references/query-workflow.md`. Summary: +Follow `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 `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>"` diff --git a/engineering/llm-wiki/agents/wiki-linter.md b/engineering/llm-wiki/agents/wiki-linter.md index 938afa6a..9e8ce2d9 100644 --- a/engineering/llm-wiki/agents/wiki-linter.md +++ b/engineering/llm-wiki/agents/wiki-linter.md @@ -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 `skills/llm-wiki/references/lint-workflow.md`. Three passes. ### Pass 1 — Mechanical (scripts) diff --git a/engineering/llm-wiki/commands/wiki-ingest.md b/engineering/llm-wiki/commands/wiki-ingest.md index e640ca2f..0738f8ff 100644 --- a/engineering/llm-wiki/commands/wiki-ingest.md +++ b/engineering/llm-wiki/commands/wiki-ingest.md @@ -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 `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 `skills/llm-wiki/scripts/update_index.py` or edits `wiki/index.md` inline +7. **Log** — runs `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` diff --git a/engineering/llm-wiki/commands/wiki-init.md b/engineering/llm-wiki/commands/wiki-init.md index e62f9575..3859f540 100644 --- a/engineering/llm-wiki/commands/wiki-init.md +++ b/engineering/llm-wiki/commands/wiki-init.md @@ -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` diff --git a/engineering/llm-wiki/commands/wiki-lint.md b/engineering/llm-wiki/commands/wiki-lint.md index 1822a2f8..0ada8b24 100644 --- a/engineering/llm-wiki/commands/wiki-lint.md +++ b/engineering/llm-wiki/commands/wiki-lint.md @@ -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 +- `skills/llm-wiki/scripts/lint_wiki.py` — orphans, broken links, stale pages, missing frontmatter, duplicate titles, log gap +- `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` diff --git a/engineering/llm-wiki/commands/wiki-log.md b/engineering/llm-wiki/commands/wiki-log.md index 404c38c4..575c626f 100644 --- a/engineering/llm-wiki/commands/wiki-log.md +++ b/engineering/llm-wiki/commands/wiki-log.md @@ -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` diff --git a/engineering/llm-wiki/commands/wiki-query.md b/engineering/llm-wiki/commands/wiki-query.md index d209dc52..c12ff50a 100644 --- a/engineering/llm-wiki/commands/wiki-query.md +++ b/engineering/llm-wiki/commands/wiki-query.md @@ -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 `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` diff --git a/engineering/skills/api-design-reviewer/SKILL.md b/engineering/skills/api-design-reviewer/SKILL.md index 2da3ca75..dba2ba62 100644 --- a/engineering/skills/api-design-reviewer/SKILL.md +++ b/engineering/skills/api-design-reviewer/SKILL.md @@ -381,7 +381,7 @@ Provides comprehensive scoring of API design quality. ### Pre-commit Hooks ```bash #!/bin/bash -python engineering/api-design-reviewer/scripts/api_linter.py api/openapi.json +python engineering/skills/api-design-reviewer/scripts/api_linter.py api/openapi.json if [ $? -ne 0 ]; then echo "API linting failed. Please fix the issues before committing." exit 1 diff --git a/engineering/skills/engineering-advanced-skills/SKILL.md b/engineering/skills/engineering-advanced-skills/SKILL.md index b75d593c..e85e5178 100644 --- a/engineering/skills/engineering-advanced-skills/SKILL.md +++ b/engineering/skills/engineering-advanced-skills/SKILL.md @@ -26,7 +26,7 @@ agents: ### Claude Code ``` -/read engineering/agent-designer/SKILL.md +/read engineering/skills/agent-designer/SKILL.md ``` ### Codex CLI diff --git a/engineering/skills/skill-security-auditor/SKILL.md b/engineering/skills/skill-security-auditor/SKILL.md index 38bda3e1..d7c72d9e 100644 --- a/engineering/skills/skill-security-auditor/SKILL.md +++ b/engineering/skills/skill-security-auditor/SKILL.md @@ -143,7 +143,7 @@ python3 scripts/skill_security_auditor.py https://github.com/user/skill-repo --s # GitHub Actions step - name: "audit-skill-security" run: | - python3 skill-security-auditor/scripts/skill_security_auditor.py ./skills/new-skill/ --strict --json > audit.json + python3 scripts/skill_security_auditor.py ./skills/new-skill/ --strict --json > audit.json if [ $? -ne 0 ]; then echo "Security audit failed"; exit 1; fi ``` diff --git a/engineering/skills/skill-tester/SKILL.md b/engineering/skills/skill-tester/SKILL.md index 7e5d56d7..4a733ce0 100644 --- a/engineering/skills/skill-tester/SKILL.md +++ b/engineering/skills/skill-tester/SKILL.md @@ -266,7 +266,7 @@ Recommendations: #!/bin/bash # .git/hooks/pre-commit echo "Running skill validation..." -python engineering/skill-tester/scripts/skill_validator.py engineering/new-skill --tier STANDARD +python engineering/skills/skill-tester/scripts/skill_validator.py engineering/new-skill --tier STANDARD if [ $? -ne 0 ]; then echo "Skill validation failed. Commit blocked." exit 1 @@ -295,9 +295,9 @@ jobs: changed_skills=$(git diff --name-only ${{ github.event.before }} | grep -E '^engineering/[^/]+/' | cut -d'/' -f1-2 | sort -u) for skill in $changed_skills; do echo "Validating $skill..." - python engineering/skill-tester/scripts/skill_validator.py $skill --json - python engineering/skill-tester/scripts/script_tester.py $skill - python engineering/skill-tester/scripts/quality_scorer.py $skill --minimum-score 75 + python engineering/skills/skill-tester/scripts/skill_validator.py $skill --json + python engineering/skills/skill-tester/scripts/script_tester.py $skill + python engineering/skills/skill-tester/scripts/quality_scorer.py $skill --minimum-score 75 done ``` @@ -307,12 +307,11 @@ jobs: # Daily quality report generation echo "Generating daily skill quality report..." timestamp=$(date +"%Y-%m-%d") -python engineering/skill-tester/scripts/quality_scorer.py engineering/ \ +python engineering/skills/skill-tester/scripts/quality_scorer.py engineering/ \ --batch --json > "reports/quality_report_${timestamp}.json" -echo "Quality trends analysis..." -python engineering/skill-tester/scripts/trend_analyzer.py reports/ \ - --days 30 > "reports/quality_trends_${timestamp}.md" +echo "Quality trends: most recent daily reports for comparison..." +ls -1t reports/quality_report_*.json | head -30 ``` ## Performance & Scalability diff --git a/engineering/skills/slo-architect/SKILL.md b/engineering/skills/slo-architect/SKILL.md index 056b5f0d..e1758733 100644 --- a/engineering/skills/slo-architect/SKILL.md +++ b/engineering/skills/slo-architect/SKILL.md @@ -155,7 +155,7 @@ This skill explicitly composes with three others: | `chaos-engineering` | Blast-radius calculator already takes monthly error budget as input — define it here | | `kubernetes-operator` | Operator capability L4 (Deep Insights) requires SLOs + Prometheus rules | -The `error_budget_calculator.py` output is in the same shape `chaos-engineering/scripts/blast_radius_calculator.py` expects on stdin. +The `error_budget_calculator.py` output is in the same shape `engineering/skills/chaos-engineering/scripts/blast_radius_calculator.py` expects on stdin. ## Workflows diff --git a/engineering/slo-architect/skills/slo-architect/SKILL.md b/engineering/slo-architect/skills/slo-architect/SKILL.md index 056b5f0d..e1758733 100644 --- a/engineering/slo-architect/skills/slo-architect/SKILL.md +++ b/engineering/slo-architect/skills/slo-architect/SKILL.md @@ -155,7 +155,7 @@ This skill explicitly composes with three others: | `chaos-engineering` | Blast-radius calculator already takes monthly error budget as input — define it here | | `kubernetes-operator` | Operator capability L4 (Deep Insights) requires SLOs + Prometheus rules | -The `error_budget_calculator.py` output is in the same shape `chaos-engineering/scripts/blast_radius_calculator.py` expects on stdin. +The `error_budget_calculator.py` output is in the same shape `engineering/skills/chaos-engineering/scripts/blast_radius_calculator.py` expects on stdin. ## Workflows diff --git a/marketing/landing/agents/cs-landing.md b/marketing/landing/agents/cs-landing.md index 72d8307d..f3d93906 100644 --- a/marketing/landing/agents/cs-landing.md +++ b/marketing/landing/agents/cs-landing.md @@ -31,11 +31,11 @@ Visual-premium-focused, motion-aware, brand-respecting. Refuses to ship a generi The cs-landing agent orchestrates the `landing` skill across HTML one-pager generation: 1. **Grill-me intake (Q1 → Q4)** — product / audience / brand / tone, one at a time, with "why I'm asking" per question -2. **Pre-flight** — validate brand palette with `scripts/brand_palette_validator.py`; generate output slug with `scripts/kebab_slug_generator.py` +2. **Pre-flight** — validate brand palette with `skills/landing/scripts/brand_palette_validator.py`; generate output slug with `skills/landing/scripts/kebab_slug_generator.py` 3. **Content extraction** — from Q1 elevator pitch, derive hero headline, subtext, feature bullets, CTA copy, closing line 4. **Brand system** — default dark navy + teal OR overridden palette 5. **Generation (single pass)** — write the .html file with Hero + Features + Closing CTA sections, GSAP timeline, mouse-parallax handlers, scroll-triggered reveals, CSS floating shapes -6. **Post-flight** — validate output with `scripts/html_validator.py` (checks: 3 sections present, CDN deps included, `gsap.set()` initial states, responsive breakpoints, no external CSS/JS files) +6. **Post-flight** — validate output with `skills/landing/scripts/html_validator.py` (checks: 3 sections present, CDN deps included, `gsap.set()` initial states, responsive breakpoints, no external CSS/JS files) 7. **Deliver** — file path (CLI) or HTML artifact (Claude.ai web) Differentiates clearly: diff --git a/orchestration/ORCHESTRATION.md b/orchestration/ORCHESTRATION.md index 65e584e1..f49a99b0 100644 --- a/orchestration/ORCHESTRATION.md +++ b/orchestration/ORCHESTRATION.md @@ -53,8 +53,8 @@ Personas know _what_ to do. Skills know _how_ to do it with precision. Load the ``` Load skills: -- engineering/aws-solution-architect/SKILL.md -- engineering/mcp-server-builder/SKILL.md +- engineering-team/skills/aws-solution-architect/SKILL.md +- engineering/skills/mcp-server-builder/SKILL.md ``` The persona drives decisions. The skills provide the structured steps, scripts, and templates. @@ -142,10 +142,10 @@ Best for: high-stakes decisions, launch readiness reviews, investor prep. No persona needed. Chain skills sequentially for procedural work. ``` -1. content-strategy/SKILL.md → Identify topics and angles -2. copywriting/SKILL.md → Write the content -3. seo-audit/SKILL.md → Optimize for search -4. analytics-tracking/SKILL.md → Set up measurement +1. marketing-skill/skills/content-strategy/SKILL.md → Identify topics and angles +2. marketing-skill/skills/copywriting/SKILL.md → Write the content +3. marketing-skill/skills/seo-audit/SKILL.md → Optimize for search +4. marketing-skill/skills/analytics-tracking/SKILL.md → Set up measurement ``` Best for: repeatable processes, content pipelines, compliance checklists. diff --git a/product-team/skills/landing-page-generator/SKILL.md b/product-team/skills/landing-page-generator/SKILL.md index dc6e0ea6..4546a045 100644 --- a/product-team/skills/landing-page-generator/SKILL.md +++ b/product-team/skills/landing-page-generator/SKILL.md @@ -30,7 +30,7 @@ Generate high-converting landing pages from a product description. Output comple Follow these steps in order for every landing page request: 1. **Gather inputs** — collect product name, tagline, audience, pain point, key benefit, pricing tiers, design style, and copy framework using the trigger format below. Ask only for missing fields. -2. **Analyze brand voice** (recommended) — if the user has existing brand content (website copy, blog posts, marketing materials), run it through `marketing-skill/content-production/scripts/brand_voice_analyzer.py` to get a voice profile (formality, tone, perspective). Use the profile to inform design style and copy framework selection: +2. **Analyze brand voice** (recommended) — if the user has existing brand content (website copy, blog posts, marketing materials), run it through `marketing-skill/skills/content-production/scripts/brand_voice_analyzer.py` to get a voice profile (formality, tone, perspective). Use the profile to inform design style and copy framework selection: - formal + professional → **enterprise** style, **AIDA** framework - casual + friendly → **bold-startup** style, **BAB** framework - professional + authoritative → **dark-saas** style, **PAS** framework @@ -193,6 +193,6 @@ Inject `FAQPage` JSON-LD via `<script type="application/ld+json" dangerouslySetI ## Related Skills -- **Brand Voice Analyzer** (`marketing-skill/content-production/scripts/brand_voice_analyzer.py`) — Run before generation to establish voice profile and ensure copy consistency +- **Brand Voice Analyzer** (`marketing-skill/skills/content-production/scripts/brand_voice_analyzer.py`) — Run before generation to establish voice profile and ensure copy consistency - **UI Design System** (`product-team/ui-design-system/`) — Generate design tokens from brand color before building the page - **Competitive Teardown** (`product-team/competitive-teardown/`) — Competitive positioning informs landing page messaging and differentiation diff --git a/product-team/skills/product-skills/SKILL.md b/product-team/skills/product-skills/SKILL.md index 191763be..806b87b0 100644 --- a/product-team/skills/product-skills/SKILL.md +++ b/product-team/skills/product-skills/SKILL.md @@ -25,7 +25,7 @@ agents: ### Claude Code ``` -/read product-team/product-manager-toolkit/SKILL.md +/read product-team/skills/product-manager-toolkit/SKILL.md ``` ### Codex CLI @@ -51,8 +51,8 @@ npx agent-skills-cli add alirezarezvani/claude-skills/product-team 9 scripts, all stdlib-only: ```bash -python3 product-manager-toolkit/scripts/rice_prioritizer.py --help -python3 product-strategist/scripts/okr_cascade_generator.py --help +python3 ../product-manager-toolkit/scripts/rice_prioritizer.py --help +python3 ../product-strategist/scripts/okr_cascade_generator.py --help ``` ## Rules diff --git a/research-ops/agents/cs-research-ops-orchestrator.md b/research-ops/agents/cs-research-ops-orchestrator.md index 3871eee5..8d6cf921 100644 --- a/research-ops/agents/cs-research-ops-orchestrator.md +++ b/research-ops/agents/cs-research-ops-orchestrator.md @@ -70,8 +70,8 @@ Hard outputs: ## Onboarding-first + autoresearch handoff -- **Onboarding-first.** When a user starts a fresh research workstream, point them at the relevant sub-skill's `scripts/onboard.py` before running its tools. Each skill has its own question set; answers persist to `~/.config/research-ops/<skill>.json` (or `./.research-ops/<skill>.json`) and pre-configure every tool. Treat customization as mandatory discipline — flag it when it's been skipped. -- **Autoresearch is opt-in and isolated.** Each sub-skill ships its own `scripts/ar_evaluator.py` bridging to `engineering/autoresearch-agent`. Invoke an autoresearch loop ONLY when the user explicitly asks to optimize / improve / run a loop. The connection is per-skill (no shared coupling): the loop edits the skill's input file; the evaluator is locked ground truth (never edited). Metrics: clinical `feasibility_composite` (↑), finance `runway_months` (↑), market `tam_divergence` (↓), product `validated_insights` (↑). +- **Onboarding-first.** When a user starts a fresh research workstream, point them at the relevant sub-skill's `skills/<sub-skill>/scripts/onboard.py` before running its tools. Each skill has its own question set; answers persist to `~/.config/research-ops/<skill>.json` (or `./.research-ops/<skill>.json`) and pre-configure every tool. Treat customization as mandatory discipline — flag it when it's been skipped. +- **Autoresearch is opt-in and isolated.** Each sub-skill ships its own `skills/<sub-skill>/scripts/ar_evaluator.py` bridging to `engineering/autoresearch-agent`. Invoke an autoresearch loop ONLY when the user explicitly asks to optimize / improve / run a loop. The connection is per-skill (no shared coupling): the loop edits the skill's input file; the evaluator is locked ground truth (never edited). Metrics: clinical `feasibility_composite` (↑), finance `runway_months` (↑), market `tam_divergence` (↓), product `validated_insights` (↑). ## When to escalate diff --git a/research-ops/commands/cs-clinical-research.md b/research-ops/commands/cs-clinical-research.md index c57436c7..146d3b1b 100644 --- a/research-ops/commands/cs-clinical-research.md +++ b/research-ops/commands/cs-clinical-research.md @@ -30,8 +30,8 @@ Run the `clinical-research` skill on this input: ## First run + optimization -- **Onboard first:** `python3 scripts/onboard.py` (area, alpha, power, dropout, named owners) — saved config pre-configures every tool. `--show` lists the questions. -- **Optimize (opt-in):** only if the user asks to optimize/run a loop, hand off to autoresearch via `scripts/ar_evaluator.py` (`feasibility_composite`, higher is better). +- **Onboard first:** `python3 skills/clinical-research/scripts/onboard.py` (area, alpha, power, dropout, named owners) — saved config pre-configures every tool. `--show` lists the questions. +- **Optimize (opt-in):** only if the user asks to optimize/run a loop, hand off to autoresearch via `skills/clinical-research/scripts/ar_evaluator.py` (`feasibility_composite`, higher is better). ## Distinct from diff --git a/research-ops/commands/cs-market-research.md b/research-ops/commands/cs-market-research.md index 43bab327..6c939565 100644 --- a/research-ops/commands/cs-market-research.md +++ b/research-ops/commands/cs-market-research.md @@ -30,8 +30,8 @@ Run the `market-research` skill on this input: ## First run + optimization -- **Onboard first:** `python3 scripts/onboard.py` (market profile, survey confidence, margin of error, sizing method) — saved config pre-configures every tool. `--show` lists the questions. -- **Optimize (opt-in):** only if the user asks to reconcile the sizing/run a loop, hand off to autoresearch via `scripts/ar_evaluator.py` (`tam_divergence`, lower is better). +- **Onboard first:** `python3 skills/market-research/scripts/onboard.py` (market profile, survey confidence, margin of error, sizing method) — saved config pre-configures every tool. `--show` lists the questions. +- **Optimize (opt-in):** only if the user asks to reconcile the sizing/run a loop, hand off to autoresearch via `skills/market-research/scripts/ar_evaluator.py` (`tam_divergence`, lower is better). ## Distinct from diff --git a/research-ops/commands/cs-product-research.md b/research-ops/commands/cs-product-research.md index c6d213ac..96e3e143 100644 --- a/research-ops/commands/cs-product-research.md +++ b/research-ops/commands/cs-product-research.md @@ -30,8 +30,8 @@ Run the `product-research` skill on this input: ## First run + optimization -- **Onboard first:** `python3 scripts/onboard.py` (product profile, insight source-threshold, saturation method, high-stakes flag) — saved config pre-configures every tool. `--show` lists the questions. -- **Optimize (opt-in):** only if the user asks to optimize the synthesis/run a loop, hand off to autoresearch via `scripts/ar_evaluator.py` (`validated_insights`, higher is better). +- **Onboard first:** `python3 skills/product-research/scripts/onboard.py` (product profile, insight source-threshold, saturation method, high-stakes flag) — saved config pre-configures every tool. `--show` lists the questions. +- **Optimize (opt-in):** only if the user asks to optimize the synthesis/run a loop, hand off to autoresearch via `skills/product-research/scripts/ar_evaluator.py` (`validated_insights`, higher is better). ## Distinct from diff --git a/research-ops/commands/cs-research-finance.md b/research-ops/commands/cs-research-finance.md index 23aeff3d..5eb81881 100644 --- a/research-ops/commands/cs-research-finance.md +++ b/research-ops/commands/cs-research-finance.md @@ -30,8 +30,8 @@ Run the `research-finance` skill on this input: ## First run + optimization -- **Onboard first:** `python3 scripts/onboard.py` (R&D area, F&A rate, runway threshold, accounting standard, finance owner) — saved config pre-configures every tool. `--show` lists the questions. -- **Optimize (opt-in):** only if the user asks to optimize/extend runway, hand off to autoresearch via `scripts/ar_evaluator.py` (`runway_months`, higher is better). +- **Onboard first:** `python3 skills/research-finance/scripts/onboard.py` (R&D area, F&A rate, runway threshold, accounting standard, finance owner) — saved config pre-configures every tool. `--show` lists the questions. +- **Optimize (opt-in):** only if the user asks to optimize/extend runway, hand off to autoresearch via `skills/research-finance/scripts/ar_evaluator.py` (`runway_months`, higher is better). ## Distinct from diff --git a/research-ops/skills/research-ops-skills/SKILL.md b/research-ops/skills/research-ops-skills/SKILL.md index ead536cf..20d979c8 100644 --- a/research-ops/skills/research-ops-skills/SKILL.md +++ b/research-ops/skills/research-ops-skills/SKILL.md @@ -107,7 +107,7 @@ Each sub-skill has its **own** question set (clinical: area/alpha/power/dropout/ ## Autoresearch handoff (isolated, opt-in) -Each sub-skill ships its own `scripts/ar_evaluator.py` — an **isolated** bridge to `engineering/autoresearch-agent`. Invoke autoresearch **only when the user explicitly asks** to "optimize", "improve", or "run a loop". The handoff is per-skill (no shared coupling): the loop edits the skill's input file and the evaluator scores it (clinical → `feasibility_composite` higher; finance → `runway_months` higher; market → `tam_divergence` lower; product → `validated_insights` higher). Never auto-start a loop; never let the loop edit the evaluator. +Each sub-skill ships its own `skills/<sub-skill>/scripts/ar_evaluator.py` — an **isolated** bridge to `engineering/autoresearch-agent`. Invoke autoresearch **only when the user explicitly asks** to "optimize", "improve", or "run a loop". The handoff is per-skill (no shared coupling): the loop edits the skill's input file and the evaluator scores it (clinical → `feasibility_composite` higher; finance → `runway_months` higher; market → `tam_divergence` lower; product → `validated_insights` higher). Never auto-start a loop; never let the loop edit the evaluator. ## Assumptions diff --git a/research/dossier/agents/cs-dossier.md b/research/dossier/agents/cs-dossier.md index d03c0458..270dd092 100644 --- a/research/dossier/agents/cs-dossier.md +++ b/research/dossier/agents/cs-dossier.md @@ -44,7 +44,7 @@ The cs-dossier agent orchestrates the `dossier` skill across hypothesis-tested e **Hard rules:** 1. **Q4 (hypothesis) is mandatory.** Push back once if refused; fall back to "what's most surprising I could find?" implicit hypothesis with flag. -2. **≥30% disconfirming search budget.** Enforced via `scripts/disconfirming_evidence_balance.py`. +2. **≥30% disconfirming search budget.** Enforced via `skills/dossier/scripts/disconfirming_evidence_balance.py`. 3. **Subject disambiguation before Phase 3.** Refuse to proceed on ambiguous names. 4. **Source-reliability tier on every flag.** Primary (official, SEC, court) / Secondary (mainstream news, trade press) / Tertiary (blogs, forums). 5. **BYOK MCP usage flagged in audit log.** Transparency on data provenance. @@ -58,15 +58,15 @@ The cs-dossier agent orchestrates the `dossier` skill across hypothesis-tested e ### Python Tools (Stdlib) -1. **Citation Tracker** — `scripts/citation_tracker.py` — three-count audit + supporting/disconfirming classification + source-tier tagging at `~/.dossier_sessions/<session>.json` -2. **Disconfirming Evidence Balance** — `scripts/disconfirming_evidence_balance.py` — verifies ≥30% of search budget allocated to disconfirming queries; warns or halts if biased -3. **Source Tier Classifier** — `scripts/source_tier_classifier.py` — given a URL, classify primary / secondary / tertiary by domain heuristics +1. **Citation Tracker** — `skills/dossier/scripts/citation_tracker.py` — three-count audit + supporting/disconfirming classification + source-tier tagging at `~/.dossier_sessions/<session>.json` +2. **Disconfirming Evidence Balance** — `skills/dossier/scripts/disconfirming_evidence_balance.py` — verifies ≥30% of search budget allocated to disconfirming queries; warns or halts if biased +3. **Source Tier Classifier** — `skills/dossier/scripts/source_tier_classifier.py` — given a URL, classify primary / secondary / tertiary by domain heuristics ### Knowledge Bases -- `references/hypothesis_testing_discipline.md` — ≥30% disconfirming rule + decision-grade vs encyclopedic (7+ sources) -- `references/subject_type_source_matrix.md` — person/company/nonprofit/gov source matrices (7+ sources) -- `references/conversation_hook_quality.md` — finding-tied hook discipline + anti-patterns (7+ sources) +- `skills/dossier/references/hypothesis_testing_discipline.md` — ≥30% disconfirming rule + decision-grade vs encyclopedic (7+ sources) +- `skills/dossier/references/subject_type_source_matrix.md` — person/company/nonprofit/gov source matrices (7+ sources) +- `skills/dossier/references/conversation_hook_quality.md` — finding-tied hook discipline + anti-patterns (7+ sources) ## Related Agents diff --git a/research/dossier/commands/cs-dossier.md b/research/dossier/commands/cs-dossier.md index cb69084e..d25cfc21 100644 --- a/research/dossier/commands/cs-dossier.md +++ b/research/dossier/commands/cs-dossier.md @@ -73,7 +73,7 @@ Example for hypothesis "Microsoft is consolidating AI spend on Foundry": | **Disconfirming** | "Microsoft AI vendor diversification" | | **Disconfirming** | "Microsoft third-party model partnerships 2026" | -`scripts/disconfirming_evidence_balance.py` enforces the ratio. Halts at <30% and prompts more disconfirming queries. +`skills/dossier/scripts/disconfirming_evidence_balance.py` enforces the ratio. Halts at <30% and prompts more disconfirming queries. ## Source Reliability Tiering @@ -85,7 +85,7 @@ Every fact in the DOCX tagged with tier (primary / secondary / tertiary): | **Secondary** | Mainstream news (NYT, WSJ, Reuters), trade press (TechCrunch, The Information) | | **Tertiary** | Blogs, forums (Reddit, HN), Glassdoor, social media | -`scripts/source_tier_classifier.py` does this from URL. +`skills/dossier/scripts/source_tier_classifier.py` does this from URL. ## Discipline (Research-Pack Convention) diff --git a/research/dossier/skills/dossier/SKILL.md b/research/dossier/skills/dossier/SKILL.md index 592c1857..f2d379e7 100644 --- a/research/dossier/skills/dossier/SKILL.md +++ b/research/dossier/skills/dossier/SKILL.md @@ -267,7 +267,7 @@ new ExternalHyperlink({ - Save: `<output-dir>/dossier_<entity-slug>_<YYYY-MM-DD>.docx` - Chat summary: file path + **verdict on hypothesis** + audit counts + tier breakdown + BYOK MCPs used (if any) -- Validate: `python scripts/office/validate.py <docx>` +- Validate: check zip integrity with `python3 -c "import zipfile,sys; zipfile.ZipFile(sys.argv[1]).testzip()" <docx>` (no output = intact), then confirm the required sections are present ## Tooling diff --git a/research/grants/agents/cs-grants.md b/research/grants/agents/cs-grants.md index 8662d79f..f6476005 100644 --- a/research/grants/agents/cs-grants.md +++ b/research/grants/agents/cs-grants.md @@ -53,15 +53,15 @@ The cs-grants agent orchestrates the `grants` skill: ### Python Tools (Stdlib) -1. **Citation Tracker** — `scripts/citation_tracker.py` — three-count audit (Consensus + RePORTER counts) at `~/.grants_sessions/<session>.json` -2. **Fiscal Year Calculator** — `scripts/fiscal_year_calculator.py` — computes current FY + 3-prior window for RePORTER queries -3. **Mechanism Matcher** — `scripts/mechanism_matcher.py` — career stage × scope × prelim → mechanism recommendation +1. **Citation Tracker** — `skills/grants/scripts/citation_tracker.py` — three-count audit (Consensus + RePORTER counts) at `~/.grants_sessions/<session>.json` +2. **Fiscal Year Calculator** — `skills/grants/scripts/fiscal_year_calculator.py` — computes current FY + 3-prior window for RePORTER queries +3. **Mechanism Matcher** — `skills/grants/scripts/mechanism_matcher.py` — career stage × scope × prelim → mechanism recommendation ### Knowledge Bases -- `references/nih_mechanism_matching.md` — career stage × scope × prelim → mechanism canon (7+ sources) -- `references/reporter_post_patterns.md` — RePORTER curl POST templates + plan-tier detection (7+ sources) -- `references/docx_9_sections.md` — 9-section .docx spec + DOCX technical requirements (7+ sources) +- `skills/grants/references/nih_mechanism_matching.md` — career stage × scope × prelim → mechanism canon (7+ sources) +- `skills/grants/references/reporter_post_patterns.md` — RePORTER curl POST templates + plan-tier detection (7+ sources) +- `skills/grants/references/docx_9_sections.md` — 9-section .docx spec + DOCX technical requirements (7+ sources) ## Related Agents diff --git a/research/grants/skills/grants/SKILL.md b/research/grants/skills/grants/SKILL.md index a2237751..eded41ec 100644 --- a/research/grants/skills/grants/SKILL.md +++ b/research/grants/skills/grants/SKILL.md @@ -118,7 +118,7 @@ RePORTER is **POST-only**. Use `bash_tool` + `curl` — never `web_fetch`. Compute at runtime via `scripts/fiscal_year_calculator.py`. Default: current FY + 3 prior. Federal FY starts Oct 1, so: ```bash -python ../scripts/fiscal_year_calculator.py --output json +python scripts/fiscal_year_calculator.py --output json # Returns: {"current_fy": 2026, "window": [2023, 2024, 2025, 2026]} ``` @@ -185,7 +185,7 @@ NOT career stage alone. Career stage **+** project scope **+** prelim data drive Use `scripts/mechanism_matcher.py`: ```bash -python ../scripts/mechanism_matcher.py \ +python scripts/mechanism_matcher.py \ --career-stage "early_career" \ --prelim-data "pilot" \ --environment "r01_eligible" \ @@ -238,7 +238,7 @@ This is the single most valuable advice for any applicant. Never skip. - Save DOCX to `<output-dir>/grants_<topic-slug>_<YYYY-MM-DD>.docx` - Chat summary: file path + audit counts + plan tier + verdict on institute targets -- Validate: `python scripts/office/validate.py <docx>` +- Validate: check zip integrity with `python3 -c "import zipfile,sys; zipfile.ZipFile(sys.argv[1]).testzip()" <docx>` (no output = intact), then confirm the required sections are present ## Tooling diff --git a/research/grants/skills/grants/references/docx_9_sections.md b/research/grants/skills/grants/references/docx_9_sections.md index b2f96c28..ec70a3ce 100644 --- a/research/grants/skills/grants/references/docx_9_sections.md +++ b/research/grants/skills/grants/references/docx_9_sections.md @@ -267,7 +267,7 @@ new Table({ After save: ```bash -python scripts/office/validate.py output.docx +python3 -c "import zipfile,sys; zipfile.ZipFile(sys.argv[1]).testzip()" output.docx ``` If validation fails: unpack DOCX (it's a ZIP), inspect document.xml, fix the offending XML, repack. diff --git a/research/litreview/README.md b/research/litreview/README.md index 1b9b4b85..9a0a65b7 100644 --- a/research/litreview/README.md +++ b/research/litreview/README.md @@ -55,7 +55,7 @@ research/litreview/ - **Consensus MCP** (required) — literature search - **`docx` Node.js library** (required) — `npm install docx` - **DOCX skill** (reference) — hyperlink / table / list / validation patterns -- **DOCX validation script** — `python scripts/office/validate.py output.docx` +- **DOCX validation step** — zip-integrity check: `python3 -c "import zipfile,sys; zipfile.ZipFile(sys.argv[1]).testzip()" output.docx` (no output = intact), then confirm required sections present ## Quick start diff --git a/research/litreview/agents/cs-litreview.md b/research/litreview/agents/cs-litreview.md index 908b81b1..eda7a01d 100644 --- a/research/litreview/agents/cs-litreview.md +++ b/research/litreview/agents/cs-litreview.md @@ -35,7 +35,7 @@ The cs-litreview agent orchestrates the `litreview` skill across academic-resear 3. **Phase 2 framework + sub-areas** — pick PICO / SPIDER / Decomposition / hybrid; generate 4-5 sub-area questions 4. **Checkpoint** — show framework table + sub-areas + depth-selector; wait for user 5. **Phase 3 searches** — sequential, 1 q/sec, budget per depth tier (5/10/20) -6. **Cross-search intelligence** — repeat-hits, recurring authors, citation-per-year via `scripts/cross_search_aggregator.py` +6. **Cross-search intelligence** — repeat-hits, recurring authors, citation-per-year via `skills/litreview/scripts/cross_search_aggregator.py` 7. **Phase 4 DOCX** — 8-section guide via Node.js + `docx` library Differentiates from siblings: @@ -52,7 +52,7 @@ Differentiates from siblings: 4. **Plan-tier detect at first search.** Report at checkpoint so user can recalibrate depth. 5. **Halt at checkpoint.** Refuse to start Phase 3 without explicit user choice. 6. **Source discipline.** Cite only Consensus-returned papers from THIS session. Training knowledge labeled `[Not from Consensus]`. -7. **Three-count tracking.** Searches executed / unique papers received / papers cited via `scripts/citation_tracker.py`. +7. **Three-count tracking.** Searches executed / unique papers received / papers cited via `skills/litreview/scripts/citation_tracker.py`. 8. **Retry once after 3s.** Then log. 3 consecutive failures → stop. ## Skill Integration @@ -102,7 +102,7 @@ python ../skills/litreview/scripts/framework_recommender.py --question "<from Q1 # Phase 4: cross-search aggregation + DOCX python ../skills/litreview/scripts/cross_search_aggregator.py --session NAME # Generate DOCX via Node.js + docx library -python scripts/office/validate.py output.docx # from docx skill +python3 -c "import zipfile,sys; zipfile.ZipFile(sys.argv[1]).testzip()" output.docx # zip-integrity check (no output = intact); then confirm required sections present python ../skills/litreview/scripts/citation_tracker.py --action close --session NAME ``` diff --git a/research/litreview/commands/cs-litreview.md b/research/litreview/commands/cs-litreview.md index 9ff20c0f..22b061a8 100644 --- a/research/litreview/commands/cs-litreview.md +++ b/research/litreview/commands/cs-litreview.md @@ -100,7 +100,7 @@ python ../skills/litreview/scripts/framework_recommender.py --question "<Q1>" # Phase 4 cross-search aggregation + DOCX python ../skills/litreview/scripts/cross_search_aggregator.py --session NAME # Generate DOCX via Node.js docx library -python scripts/office/validate.py output.docx +python3 -c "import zipfile,sys; zipfile.ZipFile(sys.argv[1]).testzip()" output.docx # zip-integrity check; then confirm required sections present python ../skills/litreview/scripts/citation_tracker.py --action close --session NAME ``` diff --git a/research/litreview/skills/litreview/SKILL.md b/research/litreview/skills/litreview/SKILL.md index 59e2e9eb..f8ce4a69 100644 --- a/research/litreview/skills/litreview/SKILL.md +++ b/research/litreview/skills/litreview/SKILL.md @@ -204,7 +204,7 @@ Document the key `docx` library patterns: - Lists: `LevelFormat.BULLET` (never unicode bullets) - Hyperlinks: `ExternalHyperlink` with `style: "Hyperlink"`, full URL (never truncated) - Tables: dual widths (`columnWidths` + cell `width`), `ShadingType.CLEAR` -- Validation step after save (`python scripts/office/validate.py output.docx`) +- Validation step after save (zip-integrity check: `python3 -c "import zipfile,sys; zipfile.ZipFile(sys.argv[1]).testzip()" output.docx` — no output = intact — then confirm the required sections are present) Reference the **docx skill** for setup patterns and best practices. diff --git a/research/litreview/skills/litreview/references/docx_8_sections.md b/research/litreview/skills/litreview/references/docx_8_sections.md index d64a215f..a689800b 100644 --- a/research/litreview/skills/litreview/references/docx_8_sections.md +++ b/research/litreview/skills/litreview/references/docx_8_sections.md @@ -236,7 +236,7 @@ new Table({ After save: ```bash -python scripts/office/validate.py output.docx +python3 -c "import zipfile,sys; zipfile.ZipFile(sys.argv[1]).testzip()" output.docx ``` If validation fails: unpack DOCX (it's a ZIP), fix the offending XML, repack. @@ -268,7 +268,7 @@ Reference the **docx skill** (`docx/SKILL.md` in this repo if installed) for ful - [ ] All Consensus URLs full (no truncation) - [ ] `LevelFormat.BULLET` for lists (no unicode bullets) - [ ] Tables have both `columnWidths` AND cell `width` -- [ ] `python scripts/office/validate.py output.docx` PASSes +- [ ] `python3 -c "import zipfile,sys; zipfile.ZipFile(sys.argv[1]).testzip()" output.docx` PASSes ## Citations (7 sources) diff --git a/research/notebooklm/agents/cs-notebooklm.md b/research/notebooklm/agents/cs-notebooklm.md index 75f9b863..0b8542f1 100644 --- a/research/notebooklm/agents/cs-notebooklm.md +++ b/research/notebooklm/agents/cs-notebooklm.md @@ -61,15 +61,15 @@ The cs-notebooklm agent orchestrates the `notebooklm` skill across NotebookLM br ### Python Tools (Stdlib) -1. **Action Router** — `scripts/action_router.py` — Q1-Q4 answers → action plan + UI flow + required parameters -2. **Custom Prompt Template Generator** — `scripts/custom_prompt_template_generator.py` — Studio output type + audience → starter custom prompt -3. **Async Action Classifier** — `scripts/async_action_classifier.py` — action name → wait-or-notify pattern (which generations block and which return immediately) +1. **Action Router** — `skills/notebooklm/scripts/action_router.py` — Q1-Q4 answers → action plan + UI flow + required parameters +2. **Custom Prompt Template Generator** — `skills/notebooklm/scripts/custom_prompt_template_generator.py` — Studio output type + audience → starter custom prompt +3. **Async Action Classifier** — `skills/notebooklm/scripts/async_action_classifier.py` — action name → wait-or-notify pattern (which generations block and which return immediately) ### Knowledge Bases -- `references/browser_automation_canon.md` — screenshot-first + find-before-click + tool-agnostic patterns (7+ sources) -- `references/studio_output_custom_prompts.md` — why defaults are mediocre + per-output-type templates (7+ sources) -- `references/async_action_discipline.md` — fire-and-notify pattern for slow UI ops (7+ sources) +- `skills/notebooklm/references/browser_automation_canon.md` — screenshot-first + find-before-click + tool-agnostic patterns (7+ sources) +- `skills/notebooklm/references/studio_output_custom_prompts.md` — why defaults are mediocre + per-output-type templates (7+ sources) +- `skills/notebooklm/references/async_action_discipline.md` — fire-and-notify pattern for slow UI ops (7+ sources) ## Related Agents diff --git a/research/patent/agents/cs-patent.md b/research/patent/agents/cs-patent.md index 13bbe42a..bbdb315c 100644 --- a/research/patent/agents/cs-patent.md +++ b/research/patent/agents/cs-patent.md @@ -28,10 +28,10 @@ tools: [Read, Write, Bash, WebFetch, WebSearch] The cs-patent agent orchestrates the `patent` skill across prior-art + landscape research: 1. **Phase 1 intake** — Q1-Q6 one at a time, with sub-use-case commitment at Q2 -2. **Phase 2 search strategy selection** — deterministic via `scripts/sub_use_case_router.py` +2. **Phase 2 search strategy selection** — deterministic via `skills/patent/scripts/sub_use_case_router.py` 3. **Phase 3 multi-source search** — Google Patents (workhorse) + Espacenet + USPTO + optional Lens.org 4. **Phase 4 claim extraction + relevance scoring** — pull independent claim 1 + key dependents -5. **Phase 5 citation graph + family resolution** — deduplicate via `scripts/family_resolver.py` +5. **Phase 5 citation graph + family resolution** — deduplicate via `skills/patent/scripts/family_resolver.py` 6. **Phase 6 DOCX** — 8 sections with sub-use-case-specific emphasis 7. **Phase 7 deliver** — file + chat summary with verdict @@ -53,15 +53,15 @@ The cs-patent agent orchestrates the `patent` skill across prior-art + landscape ### Python Tools (Stdlib) -1. **Citation Tracker** — `scripts/citation_tracker.py` — three-count audit across Google Patents + Espacenet + USPTO + Lens.org sources at `~/.patent_sessions/<session>.json` -2. **Family Resolver** — `scripts/family_resolver.py` — group same-invention filings (e.g., US + EP + JP + CN of one priority) by priority number / family ID -3. **Sub-Use-Case Router** — `scripts/sub_use_case_router.py` — deterministic search strategy from intake answers +1. **Citation Tracker** — `skills/patent/scripts/citation_tracker.py` — three-count audit across Google Patents + Espacenet + USPTO + Lens.org sources at `~/.patent_sessions/<session>.json` +2. **Family Resolver** — `skills/patent/scripts/family_resolver.py` — group same-invention filings (e.g., US + EP + JP + CN of one priority) by priority number / family ID +3. **Sub-Use-Case Router** — `skills/patent/scripts/sub_use_case_router.py` — deterministic search strategy from intake answers ### Knowledge Bases -- `references/sub_use_case_routing.md` — 5-sub-use-case canon + when each applies (7+ sources) -- `references/cpc_classification_canon.md` — CPC/IPC class follow-up rationale (7+ sources) -- `references/legal_disclaimer_discipline.md` — when + why disclaimer mandatory (7+ sources) +- `skills/patent/references/sub_use_case_routing.md` — 5-sub-use-case canon + when each applies (7+ sources) +- `skills/patent/references/cpc_classification_canon.md` — CPC/IPC class follow-up rationale (7+ sources) +- `skills/patent/references/legal_disclaimer_discipline.md` — when + why disclaimer mandatory (7+ sources) ## Related Agents diff --git a/research/patent/skills/patent/SKILL.md b/research/patent/skills/patent/SKILL.md index c03ecaaa..4f412a16 100644 --- a/research/patent/skills/patent/SKILL.md +++ b/research/patent/skills/patent/SKILL.md @@ -104,7 +104,7 @@ Asked for novelty and FTO; skipped for pure landscape (always signal-gathering b Deterministic from intake answers. Use `scripts/sub_use_case_router.py`: ```bash -python ../scripts/sub_use_case_router.py \ +python scripts/sub_use_case_router.py \ --sub-use-case novelty \ --jurisdictions "" \ --risk strict \ @@ -179,7 +179,7 @@ If no Lens.org key: skip; note in audit log; recommend manual citation review on Same invention often filed in multiple jurisdictions (US + EP + JP + CN). Group by family ID or priority number to avoid double-counting. Use `scripts/family_resolver.py`: ```bash -python ../scripts/family_resolver.py --hits-file hits.json +python scripts/family_resolver.py --hits-file hits.json # Returns: deduplicated family list + family-member jurisdictions ``` @@ -234,7 +234,7 @@ Surface the **legally-relevant date** per sub-use-case: - Save: `<output-dir>/patent_<invention-slug>_<sub-use-case>_<YYYY-MM-DD>.docx` - Chat summary: file path + sub-use-case + verdict + audit counts + plan-tier -- Validate: `python scripts/office/validate.py <docx>` +- Validate: check zip integrity with `python3 -c "import zipfile,sys; zipfile.ZipFile(sys.argv[1]).testzip()" <docx>` (no output = intact), then confirm the required sections are present - Reminder: "Consult patent attorney before filing/licensing" ## Tooling diff --git a/research/pulse/agents/cs-pulse.md b/research/pulse/agents/cs-pulse.md index eeef5ea8..0371acac 100644 --- a/research/pulse/agents/cs-pulse.md +++ b/research/pulse/agents/cs-pulse.md @@ -33,7 +33,7 @@ Relentless on specificity, depth-first on the intake tree, graceful on platform The cs-pulse agent orchestrates the `pulse` skill across multi-source recency briefings: 1. **Grill-me intake (Q1 → Q4, dependency-ordered)** — topic, angle, window, scope. One at a time. Refuse vague answers. -2. **Pre-flight** — compute window timestamps with `scripts/time_window_calculator.py`, generate output slug with `scripts/topic_slug_generator.py`, start three-count audit with `scripts/citation_tracker.py`. +2. **Pre-flight** — compute window timestamps with `skills/pulse/scripts/time_window_calculator.py`, generate output slug with `skills/pulse/scripts/topic_slug_generator.py`, start three-count audit with `skills/pulse/scripts/citation_tracker.py`. 3. **Phases 1–3 in parallel** — Reddit (top + new), HN (Algolia stories + comments), Web (2–3 targeted queries). 1 q/sec per platform; sequential within. 4. **Phase 4 (optional)** — X/Twitter if available; skip with note otherwise. 5. **Synthesis** — cross-platform pattern detection (consensus, controversy, pain, excitement, gaps). @@ -184,9 +184,9 @@ python ../skills/pulse/scripts/citation_tracker.py --action close --session NAME ## Related Agents -- [cs-grill-master](../../grill-me/agents/cs-grill-master.md) — plan-only grill (different domain) -- [cs-grill-with-docs](../../grill-with-docs/agents/cs-grill-with-docs.md) — docs-anchored grill (different scope) -- [cs-capture](../../capture/agents/cs-capture.md) — brain-dump organizer (different mode) +- [cs-grill-master](../../../engineering/grill-me/agents/cs-grill-master.md) — plan-only grill (different domain) +- [cs-grill-with-docs](../../../engineering/grill-with-docs/agents/cs-grill-with-docs.md) — docs-anchored grill (different scope) +- [cs-capture](../../../productivity/capture/agents/cs-capture.md) — brain-dump organizer (different mode) ## References diff --git a/research/research/agents/cs-research.md b/research/research/agents/cs-research.md index 7adb26ae..b8171f06 100644 --- a/research/research/agents/cs-research.md +++ b/research/research/agents/cs-research.md @@ -37,14 +37,14 @@ Router-first, transparency-mandatory, fallback-when-needed. The cs-research agent orchestrates the `research` skill as the **runtime orchestrator** for the research domain: 1. **Q1 + Q2 minimal intake** — question + output preference -2. **Deterministic classification** — run `scripts/classifier.py` on the question +2. **Deterministic classification** — run `skills/research/scripts/classifier.py` on the question 3. **Route**: - **≥2 signals for one specialist** → delegate (with transparency) - **1 signal, single specialist** → weak match, delegate (with transparency) - **Otherwise** → ask Q3 disambiguation 4. **Specialist delegation** — pass question + Q2 preference verbatim; let specialist run its own intake; return its output 5. **Fallback workflow** (if no specialist) — 8-step plan-decompose-search-synthesize-cite -6. **Log routing decision** to `scripts/routing_transparency_logger.py` for audit +6. **Log routing decision** to `skills/research/scripts/routing_transparency_logger.py` for audit Differentiates from siblings: @@ -53,7 +53,7 @@ Differentiates from siblings: **Hard rules:** -1. **Deterministic classification.** Use `scripts/classifier.py` — keyword + intent signal matching, NOT LLM-reasoned routing. +1. **Deterministic classification.** Use `skills/research/scripts/classifier.py` — keyword + intent signal matching, NOT LLM-reasoned routing. 2. **Routing transparency mandatory.** Never delegate silently. Surface decision + accept override. 3. **Specialist delegation = pass-through.** Pass question verbatim. Don't pre-answer specialist's grill-me intake. 4. **Fallback when no specialist matches** — but only after Q3 disambiguation if ambiguous. @@ -68,15 +68,15 @@ Differentiates from siblings: ### Python Tools (Stdlib) -1. **Classifier** — `scripts/classifier.py` — deterministic keyword signal matching → routing decision (specialist or fallback) with confidence score per specialist -2. **Routing Transparency Logger** — `scripts/routing_transparency_logger.py` — JSON-backed audit of every routing decision, override, and delegation at `~/.research_sessions/<session>.json` -3. **Fallback Decomposer** — `scripts/fallback_decomposer.py` — heuristic question → 3-5 sub-questions using what/why/how/who/what's next framework +1. **Classifier** — `skills/research/scripts/classifier.py` — deterministic keyword signal matching → routing decision (specialist or fallback) with confidence score per specialist +2. **Routing Transparency Logger** — `skills/research/scripts/routing_transparency_logger.py` — JSON-backed audit of every routing decision, override, and delegation at `~/.research_sessions/<session>.json` +3. **Fallback Decomposer** — `skills/research/scripts/fallback_decomposer.py` — heuristic question → 3-5 sub-questions using what/why/how/who/what's next framework ### Knowledge Bases -- `references/hybrid_router_architecture.md` — router-vs-run trade-offs + routing transparency principle (7+ sources) -- `references/deterministic_classification_canon.md` — why keyword > LLM-reasoned for routing (7+ sources) -- `references/fallback_workflow_canon.md` — plan-decompose-search-synthesize methodology (7+ sources) +- `skills/research/references/hybrid_router_architecture.md` — router-vs-run trade-offs + routing transparency principle (7+ sources) +- `skills/research/references/deterministic_classification_canon.md` — why keyword > LLM-reasoned for routing (7+ sources) +- `skills/research/references/fallback_workflow_canon.md` — plan-decompose-search-synthesize methodology (7+ sources) ## Related Agents diff --git a/research/syllabus/agents/cs-syllabus.md b/research/syllabus/agents/cs-syllabus.md index eb27457f..6d3dcc7f 100644 --- a/research/syllabus/agents/cs-syllabus.md +++ b/research/syllabus/agents/cs-syllabus.md @@ -57,9 +57,9 @@ The cs-syllabus agent orchestrates the `syllabus` skill across course-reading-li ### Python Tools (Stdlib) -1. **Citation Tracker** — `scripts/citation_tracker.py` — Consensus three-count + 1s sequential at `~/.syllabus_sessions/<session>.json` -2. **Topic Grouper** — `scripts/topic_grouper.py` — heuristic 6-12 section grouping from extracted topics -3. **Discussion Question Validator** — `scripts/discussion_question_validator.py` — Bloom higher-order quality check (rejects recall questions) +1. **Citation Tracker** — `skills/syllabus/scripts/citation_tracker.py` — Consensus three-count + 1s sequential at `~/.syllabus_sessions/<session>.json` +2. **Topic Grouper** — `skills/syllabus/scripts/topic_grouper.py` — heuristic 6-12 section grouping from extracted topics +3. **Discussion Question Validator** — `skills/syllabus/scripts/discussion_question_validator.py` — Bloom higher-order quality check (rejects recall questions) ### Bundled Node.js Script @@ -67,9 +67,9 @@ The cs-syllabus agent orchestrates the `syllabus` skill across course-reading-li ### Knowledge Bases -- `references/applied_domain_weaving.md` — search-quality canon (7+ sources) -- `references/audience_calibration.md` — undergrad vs grad summary jargon (7+ sources) -- `references/bundled_script_pattern.md` — why bundle vs inline (7+ sources) +- `skills/syllabus/references/applied_domain_weaving.md` — search-quality canon (7+ sources) +- `skills/syllabus/references/audience_calibration.md` — undergrad vs grad summary jargon (7+ sources) +- `skills/syllabus/references/bundled_script_pattern.md` — why bundle vs inline (7+ sources) ## Related Agents diff --git a/research/syllabus/skills/syllabus/SKILL.md b/research/syllabus/skills/syllabus/SKILL.md index 986657a5..42749a6d 100644 --- a/research/syllabus/skills/syllabus/SKILL.md +++ b/research/syllabus/skills/syllabus/SKILL.md @@ -182,7 +182,7 @@ Use `scripts/discussion_question_validator.py` to flag recall-only questions. ## Phase 5: Generate .docx via Bundled Script ```bash -node ../scripts/generate_reading_list.js \ +node scripts/generate_reading_list.js \ --input /tmp/syllabus_data.json \ --output /path/to/reading_list_<course>_<date>.docx ``` @@ -246,7 +246,7 @@ See [`references/bundled_script_pattern.md`](references/bundled_script_pattern.m - File path - Audit summary in chat: "Saved {file}. {N} sections × {M} papers / {K} cited. Plan tier: {tier}." -- Validate: `python scripts/office/validate.py <docx>` +- Validate: check zip integrity with `python3 -c "import zipfile,sys; zipfile.ZipFile(sys.argv[1]).testzip()" <docx>` (no output = intact), then confirm the required sections are present ## Tooling diff --git a/scripts/check_paths.py b/scripts/check_paths.py new file mode 100644 index 00000000..12d74215 --- /dev/null +++ b/scripts/check_paths.py @@ -0,0 +1,215 @@ +#!/usr/bin/env python3 +"""check_paths.py — phantom-path linter for skills, agents, and commands. + +Scans SKILL.md files plus *.md files under any agents/ or commands/ directory +for path-like references (scripts/, references/, assets/, skills/, templates/ +tokens, `python x.py` invocations, and ../ relative paths) and verifies each +candidate resolves against (a) the owning skill/plugin root, (b) the file's +own directory, or (c) the repo root. A candidate is OK if ANY base resolves. + +Known dynamic patterns (containing { < $ ~ *) and URLs are skipped. + +Exit codes: 0 = all paths resolve, 1 = at least one unresolvable path. +Intended as CI gate G1. + +Usage: + python3 scripts/check_paths.py --all # scan canonical dirs repo-wide + python3 scripts/check_paths.py FILE [FILE ...] # scan specific files + python3 scripts/check_paths.py --all --json # machine-readable output +""" + +import argparse +import json +import os +import re +import sys + +EXCLUDED_DIRS = { + ".git", ".codex", ".gemini", ".hermes", ".vibe", "docs", "audit", + "node_modules", ".github", ".claude", ".claude-plugin", +} + +# Token-style paths anchored on a canonical content dir, with a known extension. +RE_MARKER_PATH = re.compile( + r"[A-Za-z0-9_\-./]*\b(?:scripts|references|assets|skills|templates)/" + r"[A-Za-z0-9_\-./]+\.(?:py|md|sh|json|yaml|yml)\b" +) +# Any multi-segment reference to a SKILL.md file. +RE_SKILLMD = re.compile(r"[A-Za-z0-9_\-./]+/SKILL\.md\b") +# python / python3 script invocations. +RE_PY_INVOKE = re.compile(r"\bpython3?\s+([A-Za-z0-9_\-./]+\.py)\b") +# Relative parent-dir paths. +RE_RELATIVE = re.compile(r"\.\./[A-Za-z0-9_\-./]+") + +DYNAMIC_CHARS = set("{<$~*") +PLACEHOLDER_HINTS = ("path/to", "your-", "your_", "example.com", "...", "skill-name", "agent-name") +# Chars that, immediately before a match, signal a placeholder prefix was cut off +# (e.g. `{skill_path}/scripts/x.py`, `"$SKILL/scripts/x.py"`, `<plugin>/scripts/x.py`, +# `TC-001-.../tc_record.json` — a literal `.` before `../` means an `...` ellipsis). +PLACEHOLDER_PREFIX_CHARS = set("}$>*~.") +# Gitignored maintainer-local folders (see root CLAUDE.md): references into these +# are intentional dead links for cloners — not phantom paths. +MAINTAINER_LOCAL = ("megaprompts", "documentation", "eval-workspace", "tests", ".autoresearch") + + +def is_dynamic(token: str) -> bool: + if any(c in DYNAMIC_CHARS for c in token): + return True + if "://" in token or token.startswith("http"): + return True + low = token.lower() + return any(h in low for h in PLACEHOLDER_HINTS) + + +def clean(token: str) -> str: + token = token.strip().strip("`'\"()[]<>,;:") + while token.startswith("./"): + token = token[2:] + return token.rstrip(".") + + +def extract_candidates(text: str): + """Yield normalized path candidates found in text.""" + seen = set() + for regex, group in ((RE_MARKER_PATH, 0), (RE_SKILLMD, 0), (RE_PY_INVOKE, 1), (RE_RELATIVE, 0)): + for m in regex.finditer(text): + start = m.start(group) + if start > 0 and text[start - 1] in PLACEHOLDER_PREFIX_CHARS: + continue # truncated placeholder like {skill_path}/scripts/x.py + tok = clean(m.group(group)) + if not tok or "/" not in tok: + continue + if is_dynamic(tok): + continue + parts = [p for p in tok.split("/") if p and p != ".."] + if parts and parts[0] in MAINTAINER_LOCAL: + continue # intentional gitignored maintainer-local link + if tok not in seen: + seen.add(tok) + yield tok + + +def skill_root(file_path: str, repo_root: str) -> str: + """Walk up from the file's dir to the nearest skill/plugin root.""" + d = os.path.dirname(os.path.abspath(file_path)) + # If the file sits in an agents/ or commands/ dir, the plugin root is above it. + while True: + if (os.path.isfile(os.path.join(d, "SKILL.md")) + or os.path.isdir(os.path.join(d, ".claude-plugin")) + or os.path.isfile(os.path.join(d, "plugin.json"))): + return d + parent = os.path.dirname(d) + if parent == d or os.path.abspath(d) == os.path.abspath(repo_root): + return os.path.abspath(repo_root) + d = parent + + +def resolves(candidate: str, bases) -> bool: + for base in bases: + p = os.path.normpath(os.path.join(base, candidate)) + if os.path.exists(p): + return True + return False + + +def load_allowlist(repo_root: str): + """Read scripts/check_paths_allowlist.txt: `file-glob :: candidate-glob` per line. + + Each entry whitelists a known false positive (teaching examples, hypothetical + user-project paths, example tool output). Keep entries narrow — one file glob + plus one candidate glob — so real path contracts stay checked. + """ + entries = [] + path = os.path.join(repo_root, "scripts", "check_paths_allowlist.txt") + if not os.path.isfile(path): + return entries + with open(path, encoding="utf-8") as fh: + for line in fh: + line = line.split("#", 1)[0].strip() + if not line or "::" not in line: + continue + file_glob, cand_glob = (part.strip() for part in line.split("::", 1)) + if file_glob and cand_glob: + entries.append((file_glob, cand_glob)) + return entries + + +def allowlisted(rel_file: str, candidate: str, allowlist) -> bool: + import fnmatch + return any( + fnmatch.fnmatch(rel_file, fg) and fnmatch.fnmatch(candidate, cg) + for fg, cg in allowlist + ) + + +def scan_file(path: str, repo_root: str, allowlist=()): + """Return list of unresolvable path candidates in file.""" + try: + with open(path, encoding="utf-8", errors="replace") as fh: + text = fh.read() + except OSError as exc: + return [f"<unreadable: {exc}>"] + file_dir = os.path.dirname(os.path.abspath(path)) + bases = (skill_root(path, repo_root), file_dir, os.path.abspath(repo_root)) + rel_file = os.path.relpath(os.path.abspath(path), repo_root) + return [c for c in extract_candidates(text) + if not resolves(c, bases) and not allowlisted(rel_file, c, allowlist)] + + +def collect_canonical(repo_root: str): + """All SKILL.md + *.md under any agents/ or commands/ dir, excluding sync/doc trees.""" + targets = [] + for dirpath, dirnames, filenames in os.walk(repo_root): + dirnames[:] = [d for d in dirnames if d not in EXCLUDED_DIRS] + parts = os.path.relpath(dirpath, repo_root).split(os.sep) + in_canonical_dir = "agents" in parts or "commands" in parts + for fn in filenames: + if fn == "SKILL.md" or (in_canonical_dir and fn.endswith(".md")): + targets.append(os.path.join(dirpath, fn)) + return sorted(targets) + + +def main(): + ap = argparse.ArgumentParser( + description="Lint SKILL.md / agents / commands files for phantom (unresolvable) path references." + ) + ap.add_argument("files", nargs="*", help="Specific markdown files to scan") + ap.add_argument("--all", action="store_true", + help="Scan all SKILL.md + agents/*.md + commands/*.md in the repo") + ap.add_argument("--json", action="store_true", help="Emit JSON instead of human-readable output") + ap.add_argument("--root", default=os.path.dirname(os.path.dirname(os.path.abspath(__file__))), + help="Repo root (default: parent of this script)") + args = ap.parse_args() + + repo_root = os.path.abspath(args.root) + if args.all: + targets = collect_canonical(repo_root) + elif args.files: + targets = [os.path.abspath(f) for f in args.files] + else: + ap.print_help() + return 0 + + allowlist = load_allowlist(repo_root) + findings = {} + for f in targets: + bad = scan_file(f, repo_root, allowlist) + if bad: + findings[os.path.relpath(f, repo_root)] = bad + + total = sum(len(v) for v in findings.values()) + if args.json: + print(json.dumps({"files_scanned": len(targets), "files_with_findings": len(findings), + "total_unresolvable": total, "findings": findings}, indent=2)) + else: + for f in sorted(findings): + print(f"{f}:") + for p in findings[f]: + print(f" UNRESOLVABLE: {p}") + print(f"\nScanned {len(targets)} files; {len(findings)} files with findings; " + f"{total} unresolvable path references.") + return 1 if total else 0 + + +if __name__ == "__main__": + sys.exit(main()) diff --git a/scripts/check_paths_allowlist.txt b/scripts/check_paths_allowlist.txt new file mode 100644 index 00000000..6a6ee88b --- /dev/null +++ b/scripts/check_paths_allowlist.txt @@ -0,0 +1,33 @@ +# check_paths.py allowlist — known FALSE POSITIVES only. +# Format: <file-glob> :: <candidate-glob> (fnmatch on both sides) +# Every entry must be a teaching example, hypothetical user-project path, or +# example tool output — never a real path contract. Keep entries narrow. + +# Example commands inside a hypothetical ML project workflow (user's repo, not ours). +engineering-team/skills/senior-data-scientist/SKILL.md :: scripts/train.py +engineering-team/skills/senior-data-scientist/SKILL.md :: scripts/evaluate.py +engineering-team/skills/senior-data-scientist/SKILL.md :: scripts/health_check.py + +# TS import statements in generated-test / seed-script code examples (user's repo). +engineering-team/skills/senior-qa/SKILL.md :: ../src/components/Button +engineering/skills/database-schema-designer/SKILL.md :: ../src/lib/auth +engineering-team/skills/email-template-builder/SKILL.md :: ../components/layout/email-layout +engineering-team/skills/email-template-builder/SKILL.md :: ../templates/welcome +engineering-team/skills/email-template-builder/SKILL.md :: ../templates/invoice +engineering-team/skills/email-template-builder/SKILL.md :: ../i18n + +# Terragrunt/Terraform source/config_path examples (user's infra repo layout). +engineering/terraform-patterns/skills/terraform-patterns/SKILL.md :: ../../modules/vpc +engineering/terraform-patterns/skills/terraform-patterns/SKILL.md :: ../vpc + +# Example audit-report output: file names inside a fictitious audited skill. +engineering/skills/skill-security-auditor/SKILL.md :: scripts/helper.py +engineering/skills/skill-security-auditor/SKILL.md :: scripts/analyzer.py +engineering/skills/skill-security-auditor/SKILL.md :: scripts/scanner.py + +# Anti-pattern teaching example ("No references/category/subtopic.md"). +engineering/write-a-skill/commands/cs-write-a-skill.md :: references/category/subtopic.md + +# Example names of skills the extract workflow would GENERATE in the user's tree. +engineering-team/self-improving-agent/skills/extract/SKILL.md :: docker-m1-fixes/SKILL.md +engineering-team/self-improving-agent/skills/extract/SKILL.md :: api-client-regen/SKILL.md diff --git a/templates/CLAUDE.md b/templates/CLAUDE.md index 4748d9a5..3d61f818 100644 --- a/templates/CLAUDE.md +++ b/templates/CLAUDE.md @@ -12,7 +12,7 @@ This guide explains the template system for agents, commands, and standardized w ### Agent Templates -**Location:** `templates/agent-template.md` (when created) +**Location:** `templates/agent-template.md` **Usage:** Starting point for creating new cs-* agents @@ -24,29 +24,9 @@ This guide explains the template system for agents, commands, and standardized w **When to Use:** Creating any new agent in `agents/` directory -### Command Templates +### Command Templates and Workflow Templates -**Location:** `templates/command-template.md` (when created) - -**Usage:** Creating new slash commands - -**Contains:** -- Command structure -- Argument parsing patterns -- Help documentation format - -**When to Use:** Creating slash commands in `commands/` directory - -### Workflow Templates - -**Location:** `templates/workflow-template.md` (when created) - -**Usage:** Documenting standard workflows across skills - -**Contains:** -- Step-by-step format -- Expected outputs -- Error handling patterns +Not yet created. There is no command template or workflow template file in `templates/` today — when creating slash commands, copy an existing command in `commands/` (e.g. `commands/cs-backend-review.md` for the argument-hint + gate pattern) instead of looking for a template here. ## Template Usage Pattern diff --git a/templates/agent-template.md b/templates/agent-template.md index 1b564a37..f26c4a11 100644 --- a/templates/agent-template.md +++ b/templates/agent-template.md @@ -1,6 +1,6 @@ --- name: cs-agent-name -description: One-line description of what this agent does (keep under 150 characters) +description: What this agent does, followed by trigger phrasing. MUST include a "Use when…" (or "Spawn when…" / "Invoke via…") clause plus at least 1 concrete trigger example. Up to 1024 characters allowed — completeness of triggers beats brevity. Example — "Senior backend engineer agent. Use when designing APIs, picking a database, or extracting a service from a monolith (e.g., 'help me choose between Postgres and DynamoDB')." skills: skill-folder-name domain: domain-name model: sonnet @@ -14,6 +14,9 @@ tools: [Read, Write, Bash, Grep, Glob] 1. Replace "cs-agent-name" with your agent's name (use kebab-case with cs- prefix) 2. Replace "Agent Name" with the display name (Title Case) + 2b. Write the description with trigger phrasing: a "Use when…" clause + at least + 1 concrete example invocation. Descriptions may be up to 1024 characters — + do NOT compress triggers away to save space. 3. Fill in all sections below following the structure 4. Test all relative paths (../../) before committing 5. Ensure minimum 3 workflows documented @@ -289,7 +292,7 @@ python ../../domain-skill/skill-name/scripts/tool.py current-data.csv > report-$ Explain how agents complement each other. --> -- [cs-related-agent](../domain/cs-related-agent.md) - How this agent relates (e.g., "Provides strategic context for tactical execution") +- [cs-related-agent](../<domain>/cs-related-agent.md) - How this agent relates (e.g., "Provides strategic context for tactical execution") - [cs-another-agent](cs-another-agent.md) - How this agent relates (same directory) - [cs-future-agent](cs-future-agent.md) - Planned agent (mark as "planned") @@ -301,7 +304,7 @@ python ../../domain-skill/skill-name/scripts/tool.py current-data.csv > report-$ --> - **Skill Documentation:** [../../domain-skill/skill-name/SKILL.md](../../domain-skill/skill-name/SKILL.md) -- **Domain Guide:** [../../domain-skill/CLAUDE.md](../../domain-skill/CLAUDE.md) +- **Domain Guide:** [../../<domain-skill>/CLAUDE.md](../../<domain-skill>/CLAUDE.md) - **Agent Development Guide:** [../CLAUDE.md](../CLAUDE.md) ---