feat(foundation): create directory structure and standards library
- Create root-level directories: agents/, commands/, standards/, templates/ - Port 5 core standards from global Claude standards - Adapt standards for claude-skills context (cs-* prefix, Python tools, skills) - Create sprint planning documents (context.md, plan.md) - All directories tracked with .gitkeep files Standards created: - communication-standards.md (absolute honesty, zero fluff, pragmatic focus) - quality-standards.md (Python tool quality, agent workflows, testing) - git-workflow-standards.md (conventional commits, semantic versioning) - documentation-standards.md (Markdown standards, living docs, templates) - security-standards.md (secret detection, dependency security, input validation) Sprint plan ready for Days 1-6 implementation. Phase: 1 (Foundation) Issues: #8, #9
This commit is contained in:
Reza Rezvani
238
documentation/delivery/sprint-11-05-2025/context.md
Normal file
238
documentation/delivery/sprint-11-05-2025/context.md
Normal file
@@ -0,0 +1,238 @@
|
||||
# Sprint Context: Skill-Agent Integration Phase 1-2
|
||||
|
||||
**Sprint ID:** sprint-11-05-2025
|
||||
**Sprint Name:** Skill-Agent Integration Foundation
|
||||
**Start Date:** November 5, 2025
|
||||
**Target End Date:** November 19, 2025
|
||||
**Duration:** 14 days (2 weeks)
|
||||
**Sprint Type:** Foundation Build
|
||||
|
||||
---
|
||||
|
||||
## Sprint Goal
|
||||
|
||||
**Primary Goal:**
|
||||
Build the foundational agent integration system for claude-code-skills, enabling users to invoke specialized cs-* agents that seamlessly integrate with the existing 42 production skills.
|
||||
|
||||
**Success Criteria:**
|
||||
- ✅ Root-level directory structure created (agents/, commands/, standards/, templates/)
|
||||
- ✅ 5 core standards ported from factory and adapted
|
||||
- ✅ 5 agents fully implemented (cs-content-creator, cs-demand-gen-specialist, cs-ceo-advisor, cs-cto-advisor, cs-product-manager)
|
||||
- ✅ Agent template and creation guide complete
|
||||
- ✅ All relative paths resolve correctly
|
||||
- ✅ Python tools execute successfully from agent context
|
||||
- ✅ Documentation updated (README, INSTALL, USAGE, CLAUDE)
|
||||
- ✅ All quality gates pass
|
||||
|
||||
---
|
||||
|
||||
## Context & Background
|
||||
|
||||
### Why This Sprint?
|
||||
|
||||
The claude-code-skills repository currently contains 42 production-ready skills across 6 domains (marketing, C-level advisory, product team, project management, engineering, RA/QM). Each skill includes Python automation tools, knowledge bases, and templates.
|
||||
|
||||
**Current Gap:**
|
||||
- Skills exist as standalone packages
|
||||
- No orchestration layer for workflows
|
||||
- Users must manually invoke Python scripts
|
||||
- No guided workflows or best practices
|
||||
|
||||
**Solution:**
|
||||
Agent integration provides a workflow orchestration layer where specialized agents (cs-* prefix) invoke skills, coordinate Python tools, and guide users through complex multi-step processes.
|
||||
|
||||
### Strategic Value
|
||||
|
||||
1. **User Experience:** Transform from "tool collection" to "guided workflows"
|
||||
2. **Marketplace Ready:** Foundation for Anthropic plugin marketplace distribution
|
||||
3. **Scalability:** Template system enables rapid expansion to 42+ agents
|
||||
4. **Differentiation:** Only skill library with built-in agent orchestration
|
||||
|
||||
---
|
||||
|
||||
## Scope
|
||||
|
||||
### In Scope (Phase 1-2)
|
||||
|
||||
**Phase 1: Core Structure (Days 1)**
|
||||
- Root-level directory creation
|
||||
- Standards library (5 files)
|
||||
|
||||
**Phase 2: Agent Implementation (Days 2-4)**
|
||||
- Marketing agents (2)
|
||||
- C-level agents (2)
|
||||
- Product agent (1)
|
||||
- Agent template & creation guide
|
||||
|
||||
**Phase 4-5: Documentation & Testing (Days 5-6)**
|
||||
- Documentation updates (README, INSTALL, USAGE, CLAUDE)
|
||||
- Comprehensive testing & validation
|
||||
|
||||
### Out of Scope (Future Phases)
|
||||
|
||||
- Installation script (install.sh) → Phase 3
|
||||
- Uninstall script (uninstall.sh) → Phase 3
|
||||
- Remaining 37 agents (project management, engineering, RA/QM) → Future sprints
|
||||
- Plugin marketplace submission → Phase 6-7
|
||||
- Backwards compatibility migration → Phase 3
|
||||
|
||||
---
|
||||
|
||||
## Key Stakeholders
|
||||
|
||||
**Primary:**
|
||||
- Repository users (developers, product teams, marketers, executives)
|
||||
- Future Anthropic marketplace users
|
||||
|
||||
**Secondary:**
|
||||
- Contributors to claude-code-skills
|
||||
- Teams using skills in production
|
||||
|
||||
---
|
||||
|
||||
## Dependencies
|
||||
|
||||
### External Dependencies
|
||||
|
||||
1. **GitHub Automation** ✅ (Complete)
|
||||
- Smart-sync workflow configured
|
||||
- PROJECTS_TOKEN secret added
|
||||
- Project #9 board configured
|
||||
- Labels created
|
||||
|
||||
2. **Existing Skills** ✅ (Complete)
|
||||
- 42 production skills
|
||||
- 97 Python automation tools
|
||||
- Complete knowledge bases
|
||||
|
||||
### Internal Dependencies
|
||||
|
||||
1. **Implementation Plan** ✅ (Complete)
|
||||
- `documentation/implementation/implementation-plan-november-2025.md`
|
||||
- 50+ pages with detailed specifications
|
||||
|
||||
2. **GitHub Issues** ✅ (Complete)
|
||||
- 8 issues created (#8-#16, excluding #10)
|
||||
- All linked to Milestone: Skill-Agent Integration v1.0
|
||||
- All on Project #9 board
|
||||
|
||||
3. **Factory Reference** ✅ (Available)
|
||||
- claude-code-skills-factory project
|
||||
- Standards files to port
|
||||
- Agent patterns to reference
|
||||
|
||||
---
|
||||
|
||||
## Risks & Mitigation
|
||||
|
||||
### Risk 1: Relative Path Resolution Failures
|
||||
**Probability:** Medium
|
||||
**Impact:** High
|
||||
**Mitigation:**
|
||||
- Test paths early and often
|
||||
- Create validation script for path testing
|
||||
- Document path patterns in creation guide
|
||||
**Fallback:** Use absolute paths with environment variables
|
||||
|
||||
### Risk 2: Python Tool Execution Issues
|
||||
**Probability:** Low
|
||||
**Impact:** Medium
|
||||
**Mitigation:**
|
||||
- Test each tool from agent context
|
||||
- Verify working directory assumptions
|
||||
- Document execution requirements
|
||||
**Fallback:** Provide wrapper scripts
|
||||
|
||||
### Risk 3: Scope Creep (Trying to do all 42 agents)
|
||||
**Probability:** High
|
||||
**Impact:** High
|
||||
**Mitigation:**
|
||||
- Strict focus on 5 foundational agents
|
||||
- Template system enables future expansion
|
||||
- Document "out of scope" clearly
|
||||
**Fallback:** Defer additional agents to future sprints
|
||||
|
||||
### Risk 4: Documentation Burden
|
||||
**Probability:** Medium
|
||||
**Impact:** Medium
|
||||
**Mitigation:**
|
||||
- Use agent template to standardize
|
||||
- Reference existing skill documentation
|
||||
- Keep agent docs focused on workflows
|
||||
**Fallback:** Minimal viable documentation for v1.0
|
||||
|
||||
---
|
||||
|
||||
## Success Metrics
|
||||
|
||||
### Quantitative Metrics
|
||||
|
||||
- **Directory Structure:** 10 directories created
|
||||
- **Standards Files:** 5 files ported and adapted
|
||||
- **Agents Created:** 5 agents fully implemented
|
||||
- **Documentation Files:** 4 files updated/created
|
||||
- **Test Coverage:** 100% of agents tested
|
||||
- **Path Resolution:** 100% success rate
|
||||
- **Python Tool Execution:** 100% success rate
|
||||
|
||||
### Qualitative Metrics
|
||||
|
||||
- **User Experience:** Clear, guided workflows in each agent
|
||||
- **Code Quality:** All quality gates pass
|
||||
- **Documentation Quality:** Beginner-friendly, actionable
|
||||
- **Maintainability:** Template enables easy agent creation
|
||||
- **Architecture:** Clean separation of skills vs agents
|
||||
|
||||
---
|
||||
|
||||
## Sprint Team
|
||||
|
||||
**Lead:** Implementation Team
|
||||
**Contributors:**
|
||||
- Documentation Team
|
||||
- Quality Assurance Team
|
||||
|
||||
**Reviewers:**
|
||||
- Repository Maintainer
|
||||
- Domain Experts (marketing, C-level, product)
|
||||
|
||||
---
|
||||
|
||||
## Related Documents
|
||||
|
||||
- **Implementation Plan:** `documentation/implementation/implementation-plan-november-2025.md`
|
||||
- **GitHub Milestone:** [Skill-Agent Integration v1.0](https://github.com/alirezarezvani/claude-skills/milestone/1)
|
||||
- **Project Board:** [Project #9: @claude-code-skills](https://github.com/users/alirezarezvani/projects/9)
|
||||
- **GitHub Issues:** #8, #9, #11, #12, #13, #14, #15, #16
|
||||
- **Factory Reference:** `/Users/rezarezvani/projects/claude-code-skills-factory`
|
||||
|
||||
---
|
||||
|
||||
## Sprint Schedule Overview
|
||||
|
||||
**Week 1 (Nov 5-8):**
|
||||
- Days 1: Foundation (directories, standards)
|
||||
- Days 2-4: Agents (marketing, C-level, product)
|
||||
|
||||
**Week 2 (Nov 11-15):**
|
||||
- Days 5-6: Documentation & testing
|
||||
- Buffer: 3 days for unexpected issues
|
||||
|
||||
**Target Completion:** November 15, 2025 (4 days buffer before Nov 19 deadline)
|
||||
|
||||
---
|
||||
|
||||
## Next Steps
|
||||
|
||||
1. ✅ Review sprint plan (context.md + plan.md)
|
||||
2. ✅ Confirm sprint goals and scope
|
||||
3. ✅ Begin implementation in optimal order
|
||||
4. Track progress daily on Project #9 board
|
||||
5. Update living docs (README, CLAUDE) as we complete phases
|
||||
|
||||
---
|
||||
|
||||
**Document Version:** 1.0
|
||||
**Created:** November 5, 2025
|
||||
**Last Updated:** November 5, 2025
|
||||
**Status:** Active Sprint
|
||||
866
documentation/delivery/sprint-11-05-2025/plan.md
Normal file
866
documentation/delivery/sprint-11-05-2025/plan.md
Normal file
@@ -0,0 +1,866 @@
|
||||
# Sprint Plan: Skill-Agent Integration Phase 1-2
|
||||
|
||||
**Sprint:** sprint-11-05-2025
|
||||
**Duration:** 14 days (Nov 5 - Nov 19, 2025)
|
||||
**Target Completion:** Day 6 (Nov 15, 2025) with 4-day buffer
|
||||
|
||||
---
|
||||
|
||||
## Sprint Execution Strategy
|
||||
|
||||
### Critical Path (Must Complete in Sequence)
|
||||
|
||||
```
|
||||
Day 1: Foundation
|
||||
↓
|
||||
Days 2-4: Parallel Agent Development
|
||||
↓
|
||||
Days 5-6: Documentation & Testing
|
||||
```
|
||||
|
||||
### Work Distribution
|
||||
|
||||
- **Sequential Work:** Days 1 (foundation must complete first)
|
||||
- **Parallel Work:** Days 2-4 (agents can be built concurrently once foundation exists)
|
||||
- **Final Integration:** Days 5-6 (documentation and testing)
|
||||
|
||||
---
|
||||
|
||||
## Day 1: Foundation Build (November 5, 2025)
|
||||
|
||||
**Goal:** Complete Phase 1 - Establish directory structure and standards library
|
||||
|
||||
**Status:** 🎯 START HERE
|
||||
|
||||
### Morning Session (3 hours)
|
||||
|
||||
#### Task 1.1: Create Root Directory Structure
|
||||
**GitHub Issue:** [#8 - Create root-level directory structure](https://github.com/alirezarezvani/claude-skills/issues/8)
|
||||
**Estimated Time:** 30 minutes
|
||||
**Priority:** P1 - CRITICAL (blocks all other work)
|
||||
|
||||
**Steps:**
|
||||
```bash
|
||||
# 1. Create agent directories
|
||||
mkdir -p agents/marketing
|
||||
mkdir -p agents/c-level
|
||||
mkdir -p agents/product
|
||||
|
||||
# 2. Create commands directory
|
||||
mkdir -p commands
|
||||
|
||||
# 3. Create standards directories
|
||||
mkdir -p standards/communication
|
||||
mkdir -p standards/quality
|
||||
mkdir -p standards/git
|
||||
mkdir -p standards/documentation
|
||||
mkdir -p standards/security
|
||||
|
||||
# 4. Create templates directory
|
||||
mkdir -p templates
|
||||
|
||||
# 5. Verify structure
|
||||
tree agents commands standards templates
|
||||
|
||||
# 6. Update .gitignore if needed
|
||||
# (ensure these directories are tracked, not ignored)
|
||||
```
|
||||
|
||||
**Acceptance Criteria:**
|
||||
- [ ] All 10 directories created
|
||||
- [ ] No conflicts with existing structure
|
||||
- [ ] Directories tracked by git
|
||||
- [ ] Structure matches implementation plan
|
||||
|
||||
**Deliverable:** Directory structure ready for content
|
||||
|
||||
---
|
||||
|
||||
#### Task 1.2: Port Core Standards from Factory
|
||||
**GitHub Issue:** [#9 - Port core standards from factory](https://github.com/alirezarezvani/claude-skills/issues/9)
|
||||
**Estimated Time:** 2.5 hours
|
||||
**Priority:** P1 - HIGH
|
||||
**Depends On:** Task 1.1 (directories must exist)
|
||||
|
||||
**Standards to Port:**
|
||||
|
||||
1. **communication-standards.md** (30 min)
|
||||
```bash
|
||||
# Source: ~/projects/claude-code-skills-factory/.claude/standards/communication/
|
||||
# Target: standards/communication/communication-standards.md
|
||||
```
|
||||
- Replace factory-specific references → claude-skills context
|
||||
- Replace rr-* agents → cs-* agents
|
||||
- Update file paths to root-level structure
|
||||
- Validate: No broken links, markdown passes linting
|
||||
|
||||
2. **quality-standards.md** (30 min)
|
||||
```bash
|
||||
# Source: factory/.claude/standards/quality/
|
||||
# Target: standards/quality/quality-standards.md
|
||||
```
|
||||
- Code quality requirements
|
||||
- Testing standards (focus on Python tool testing)
|
||||
- Review checklist
|
||||
|
||||
3. **git-workflow-standards.md** (30 min)
|
||||
```bash
|
||||
# Source: factory/.claude/standards/git/
|
||||
# Target: standards/git/git-workflow-standards.md
|
||||
```
|
||||
- Conventional commits
|
||||
- Branch naming
|
||||
- PR requirements
|
||||
- Commit message templates
|
||||
|
||||
4. **documentation-standards.md** (30 min)
|
||||
```bash
|
||||
# Source: factory/.claude/standards/documentation/
|
||||
# Target: standards/documentation/documentation-standards.md
|
||||
```
|
||||
- Markdown formatting
|
||||
- File naming conventions
|
||||
- Structure requirements
|
||||
- Living documentation principles
|
||||
|
||||
5. **security-standards.md** (30 min)
|
||||
```bash
|
||||
# Source: factory/.claude/standards/security/
|
||||
# Target: standards/security/security-standards.md
|
||||
```
|
||||
- Secret detection
|
||||
- Dependency scanning
|
||||
- Security checklist
|
||||
- Vulnerability reporting
|
||||
|
||||
**Acceptance Criteria:**
|
||||
- [ ] All 5 standards files created
|
||||
- [ ] No factory-specific references
|
||||
- [ ] All references point to claude-skills architecture
|
||||
- [ ] Files pass markdown linting
|
||||
- [ ] Standards are actionable
|
||||
|
||||
**Deliverable:** Complete standards library
|
||||
|
||||
---
|
||||
|
||||
### Afternoon Session (1 hour)
|
||||
|
||||
#### Task 1.3: Commit Day 1 Work
|
||||
**Estimated Time:** 30 minutes
|
||||
|
||||
```bash
|
||||
# Review changes
|
||||
git status
|
||||
git diff
|
||||
|
||||
# Stage files
|
||||
git add agents/ commands/ standards/ templates/
|
||||
|
||||
# Commit with conventional message
|
||||
git commit -m "feat(foundation): create directory structure and standards library
|
||||
|
||||
- Create root-level directories: agents/, commands/, standards/, templates/
|
||||
- Port 5 core standards from factory
|
||||
- Adapt standards for claude-skills context
|
||||
- Replace rr-* references with cs-* prefix
|
||||
|
||||
Phase: 1 (Foundation)
|
||||
Issues: #8, #9"
|
||||
|
||||
# Push to dev branch
|
||||
git push origin dev
|
||||
```
|
||||
|
||||
#### Task 1.4: Update Issue Status
|
||||
**Estimated Time:** 15 minutes
|
||||
|
||||
```bash
|
||||
# Close completed issues
|
||||
gh issue close 8 --comment "✅ Directory structure created and verified"
|
||||
gh issue close 9 --comment "✅ All 5 standards ported and adapted"
|
||||
|
||||
# Move to next phase
|
||||
gh issue edit 11 --remove-label "status:ready" --add-label "status:in-progress"
|
||||
```
|
||||
|
||||
#### Task 1.5: Day 1 Validation
|
||||
**Estimated Time:** 15 minutes
|
||||
|
||||
- [ ] Run `/review` command (validate YAML, markdown)
|
||||
- [ ] Verify directory structure exists
|
||||
- [ ] Verify all 5 standards files created
|
||||
- [ ] Check for broken links
|
||||
- [ ] Markdown linting passes
|
||||
|
||||
**End of Day 1 Status:**
|
||||
- ✅ Foundation complete
|
||||
- ✅ Ready for agent development
|
||||
- ✅ Issues #8, #9 closed
|
||||
|
||||
---
|
||||
|
||||
## Days 2-4: Agent Development (November 6-8, 2025)
|
||||
|
||||
**Goal:** Implement 5 foundational agents + template
|
||||
|
||||
**Strategy:** Can work on agents in parallel (different domains)
|
||||
|
||||
### Day 2: Marketing Domain Agents
|
||||
|
||||
#### Task 2.1: Create cs-content-creator Agent
|
||||
**GitHub Issue:** [#11 - Create marketing agents](https://github.com/alirezarezvani/claude-skills/issues/11)
|
||||
**Estimated Time:** 2 hours
|
||||
**Priority:** P1 - HIGH
|
||||
|
||||
**File:** `agents/marketing/cs-content-creator.md`
|
||||
|
||||
**Structure to Create:**
|
||||
|
||||
```yaml
|
||||
---
|
||||
name: cs-content-creator
|
||||
description: Create SEO-optimized marketing content with brand voice consistency
|
||||
skills: content-creator
|
||||
domain: marketing
|
||||
model: sonnet
|
||||
tools: [Read, Write, Bash, Grep, Glob]
|
||||
---
|
||||
|
||||
# Content Creator Agent
|
||||
|
||||
## Purpose
|
||||
[1 paragraph describing what this agent does]
|
||||
|
||||
## Skill Integration
|
||||
|
||||
**Skill Location:** `../../marketing-skill/content-creator/`
|
||||
|
||||
### Python Tools
|
||||
|
||||
**Brand Voice Analyzer:**
|
||||
```bash
|
||||
python ../../marketing-skill/content-creator/scripts/brand_voice_analyzer.py input.txt
|
||||
python ../../marketing-skill/content-creator/scripts/brand_voice_analyzer.py input.txt json
|
||||
```
|
||||
|
||||
**SEO Optimizer:**
|
||||
```bash
|
||||
python ../../marketing-skill/content-creator/scripts/seo_optimizer.py article.md "primary keyword"
|
||||
python ../../marketing-skill/content-creator/scripts/seo_optimizer.py article.md "primary keyword" "secondary,keywords"
|
||||
```
|
||||
|
||||
### Knowledge Bases
|
||||
- Brand Guidelines: `../../marketing-skill/content-creator/references/brand_guidelines.md`
|
||||
- Content Frameworks: `../../marketing-skill/content-creator/references/content_frameworks.md`
|
||||
- Social Media Optimization: `../../marketing-skill/content-creator/references/social_media_optimization.md`
|
||||
|
||||
### Templates
|
||||
- Content Calendar: `../../marketing-skill/content-creator/assets/content-calendar-template.md`
|
||||
- Brand Voice Checklist: `../../marketing-skill/content-creator/assets/brand-voice-checklist.md`
|
||||
|
||||
## Workflows
|
||||
|
||||
### Workflow 1: Create Blog Post
|
||||
[Detailed step-by-step workflow]
|
||||
|
||||
### Workflow 2: Create Social Media Campaign
|
||||
[Detailed step-by-step workflow]
|
||||
|
||||
### Workflow 3: Analyze Brand Voice
|
||||
[Detailed step-by-step workflow]
|
||||
|
||||
## Integration Examples
|
||||
[Concrete code examples]
|
||||
|
||||
## Success Metrics
|
||||
[How to measure effectiveness]
|
||||
|
||||
## Related Agents
|
||||
- cs-demand-gen-specialist (acquisition campaigns)
|
||||
- cs-product-marketing (product launches)
|
||||
|
||||
## References
|
||||
- Skill Documentation: `../../marketing-skill/content-creator/SKILL.md`
|
||||
- Standards: `../../standards/communication/communication-standards.md`
|
||||
```
|
||||
|
||||
**Testing:**
|
||||
```bash
|
||||
# Test relative paths
|
||||
cd agents/marketing
|
||||
ls ../../marketing-skill/content-creator/scripts/brand_voice_analyzer.py
|
||||
ls ../../marketing-skill/content-creator/references/brand_guidelines.md
|
||||
|
||||
# Test Python tool execution
|
||||
python ../../marketing-skill/content-creator/scripts/brand_voice_analyzer.py \
|
||||
../../marketing-skill/content-creator/SKILL.md
|
||||
|
||||
# Back to root
|
||||
cd ../..
|
||||
```
|
||||
|
||||
**Acceptance Criteria:**
|
||||
- [ ] Complete YAML frontmatter
|
||||
- [ ] All relative paths resolve
|
||||
- [ ] 3 workflows documented
|
||||
- [ ] Integration examples present
|
||||
- [ ] Python tools tested
|
||||
- [ ] No broken links
|
||||
|
||||
---
|
||||
|
||||
#### Task 2.2: Create cs-demand-gen-specialist Agent
|
||||
**GitHub Issue:** [#11 - Create marketing agents](https://github.com/alirezarezvani/claude-skills/issues/11)
|
||||
**Estimated Time:** 2 hours
|
||||
**Priority:** P1 - HIGH
|
||||
|
||||
**File:** `agents/marketing/cs-demand-gen-specialist.md`
|
||||
|
||||
**Structure:** Similar to cs-content-creator
|
||||
- YAML frontmatter
|
||||
- Skill integration: `../../marketing-skill/marketing-demand-acquisition/`
|
||||
- Python tool: campaign_analyzer.py
|
||||
- Workflows: Lead gen, conversion optimization, funnel analysis
|
||||
|
||||
**Testing:** Same pattern as Task 2.1
|
||||
|
||||
---
|
||||
|
||||
### Day 3: C-Level Advisory Agents
|
||||
|
||||
#### Task 3.1: Create cs-ceo-advisor Agent
|
||||
**GitHub Issue:** [#12 - Create C-level agents](https://github.com/alirezarezvani/claude-skills/issues/12)
|
||||
**Estimated Time:** 2 hours
|
||||
**Priority:** P1 - HIGH
|
||||
|
||||
**File:** `agents/c-level/cs-ceo-advisor.md`
|
||||
|
||||
**Structure:**
|
||||
- YAML frontmatter
|
||||
- Skill integration: `../../c-level-advisor/ceo-advisor/`
|
||||
- Python tools: strategic_framework_generator.py, scenario_planner.py, okr_tracker.py
|
||||
- Workflows: Strategic planning, OKR setting, board deck prep, scenario analysis
|
||||
|
||||
---
|
||||
|
||||
#### Task 3.2: Create cs-cto-advisor Agent
|
||||
**GitHub Issue:** [#12 - Create C-level agents](https://github.com/alirezarezvani/claude-skills/issues/12)
|
||||
**Estimated Time:** 2 hours
|
||||
**Priority:** P1 - HIGH
|
||||
|
||||
**File:** `agents/c-level/cs-cto-advisor.md`
|
||||
|
||||
**Structure:**
|
||||
- YAML frontmatter
|
||||
- Skill integration: `../../c-level-advisor/cto-advisor/`
|
||||
- Python tools: tech_stack_analyzer.py, architecture_auditor.py, team_velocity_tracker.py
|
||||
- Workflows: Tech roadmap, build vs buy, tech debt, team scaling
|
||||
|
||||
---
|
||||
|
||||
### Day 4: Product Agent + Template
|
||||
|
||||
#### Task 4.1: Create cs-product-manager Agent
|
||||
**GitHub Issue:** [#13 - Create product agent](https://github.com/alirezarezvani/claude-skills/issues/13)
|
||||
**Estimated Time:** 1.5 hours
|
||||
**Priority:** P1 - HIGH
|
||||
|
||||
**File:** `agents/product/cs-product-manager.md`
|
||||
|
||||
**Structure:**
|
||||
- YAML frontmatter
|
||||
- Skill integration: `../../product-team/product-manager-toolkit/`
|
||||
- Python tools: rice_prioritizer.py, customer_interview_analyzer.py
|
||||
- Workflows: Feature prioritization, interview analysis, roadmap generation, quarterly planning
|
||||
|
||||
---
|
||||
|
||||
#### Task 4.2: Create Agent Template & Creation Guide
|
||||
**GitHub Issue:** [#14 - Create agent template and guide](https://github.com/alirezarezvani/claude-skills/issues/14)
|
||||
**Estimated Time:** 2 hours
|
||||
**Priority:** P2 - MEDIUM
|
||||
|
||||
**File 1:** `templates/agent-template.md`
|
||||
- Complete structure with YAML frontmatter
|
||||
- Placeholder sections
|
||||
- Comments explaining each section
|
||||
- Reference all 5 completed agents as examples
|
||||
|
||||
**File 2:** `documentation/AGENT_CREATION_GUIDE.md`
|
||||
- Step-by-step creation process
|
||||
- Naming conventions (cs-* prefix, kebab-case)
|
||||
- Relative path resolution guide
|
||||
- Testing checklist
|
||||
- Validation steps
|
||||
- Troubleshooting section
|
||||
|
||||
---
|
||||
|
||||
#### Task 4.3: Commit Days 2-4 Work
|
||||
**Estimated Time:** 30 minutes
|
||||
|
||||
```bash
|
||||
# Review all agents
|
||||
git status
|
||||
git diff agents/
|
||||
|
||||
# Stage agents
|
||||
git add agents/marketing/cs-content-creator.md
|
||||
git add agents/marketing/cs-demand-gen-specialist.md
|
||||
git add agents/c-level/cs-ceo-advisor.md
|
||||
git add agents/c-level/cs-cto-advisor.md
|
||||
git add agents/product/cs-product-manager.md
|
||||
git add templates/agent-template.md
|
||||
git add documentation/AGENT_CREATION_GUIDE.md
|
||||
|
||||
# Commit
|
||||
git commit -m "feat(agents): implement 5 foundational agents and template
|
||||
|
||||
- Create cs-content-creator (marketing domain)
|
||||
- Create cs-demand-gen-specialist (marketing domain)
|
||||
- Create cs-ceo-advisor (C-level domain)
|
||||
- Create cs-cto-advisor (C-level domain)
|
||||
- Create cs-product-manager (product domain)
|
||||
- Create agent template for future expansion
|
||||
- Add comprehensive agent creation guide
|
||||
|
||||
All agents tested with relative path resolution and Python tool execution.
|
||||
|
||||
Phase: 2 (Agents)
|
||||
Issues: #11, #12, #13, #14"
|
||||
|
||||
# Push
|
||||
git push origin dev
|
||||
```
|
||||
|
||||
#### Task 4.4: Update Issue Status
|
||||
```bash
|
||||
# Close completed issues
|
||||
gh issue close 11 --comment "✅ Marketing agents (cs-content-creator, cs-demand-gen-specialist) implemented and tested"
|
||||
gh issue close 12 --comment "✅ C-level agents (cs-ceo-advisor, cs-cto-advisor) implemented and tested"
|
||||
gh issue close 13 --comment "✅ Product agent (cs-product-manager) implemented and tested"
|
||||
gh issue close 14 --comment "✅ Agent template and creation guide complete"
|
||||
|
||||
# Start documentation phase
|
||||
gh issue edit 15 --remove-label "status:backlog" --add-label "status:in-progress"
|
||||
```
|
||||
|
||||
**End of Day 4 Status:**
|
||||
- ✅ 5 agents implemented
|
||||
- ✅ Agent template created
|
||||
- ✅ Creation guide complete
|
||||
- ✅ Issues #11, #12, #13, #14 closed
|
||||
|
||||
---
|
||||
|
||||
## Days 5-6: Documentation & Testing (November 11-12, 2025)
|
||||
|
||||
**Goal:** Update project documentation and validate all deliverables
|
||||
|
||||
### Day 5: Documentation Updates
|
||||
|
||||
#### Task 5.1: Update README.md
|
||||
**GitHub Issue:** [#15 - Update project documentation](https://github.com/alirezarezvani/claude-skills/issues/15)
|
||||
**Estimated Time:** 1 hour
|
||||
|
||||
**Sections to Add:**
|
||||
|
||||
1. **Quick Start** (add near top)
|
||||
```markdown
|
||||
## 🚀 Quick Start
|
||||
|
||||
### Installation
|
||||
```bash
|
||||
git clone https://github.com/alirezarezvani/claude-skills.git
|
||||
cd claude-skills
|
||||
# TODO: ./install.sh (Phase 3)
|
||||
```
|
||||
|
||||
### Use Your First Agent
|
||||
```bash
|
||||
# Invoke content creator agent
|
||||
claude-code --agent cs-content-creator
|
||||
|
||||
# Or use directly in workflows
|
||||
```
|
||||
|
||||
See [INSTALL.md](INSTALL.md) for detailed setup.
|
||||
```
|
||||
|
||||
2. **Agent Catalog** (new section)
|
||||
```markdown
|
||||
## 🤖 Agent Catalog
|
||||
|
||||
Specialized agents that orchestrate skills and provide guided workflows.
|
||||
|
||||
| Agent | Domain | Skills Used | Description |
|
||||
|-------|--------|-------------|-------------|
|
||||
| [cs-content-creator](agents/marketing/cs-content-creator.md) | Marketing | content-creator | SEO-optimized content with brand voice |
|
||||
| [cs-demand-gen-specialist](agents/marketing/cs-demand-gen-specialist.md) | Marketing | marketing-demand-acquisition | Lead gen and conversion optimization |
|
||||
| [cs-ceo-advisor](agents/c-level/cs-ceo-advisor.md) | C-Level | ceo-advisor | Strategic planning and OKR setting |
|
||||
| [cs-cto-advisor](agents/c-level/cs-cto-advisor.md) | C-Level | cto-advisor | Tech roadmap and architecture decisions |
|
||||
| [cs-product-manager](agents/product/cs-product-manager.md) | Product | product-manager-toolkit | RICE prioritization and roadmapping |
|
||||
|
||||
[View all 42 skills →](README.md#skills-overview)
|
||||
```
|
||||
|
||||
3. **Skills vs Agents** (explanation section)
|
||||
```markdown
|
||||
## 💡 Skills vs Agents
|
||||
|
||||
**Skills** = Python tools + knowledge bases + templates
|
||||
- 42 production-ready skills
|
||||
- 97 automation tools
|
||||
- Domain expertise packaged
|
||||
|
||||
**Agents** = Workflow orchestrators
|
||||
- Invoke skills intelligently
|
||||
- Guide multi-step processes
|
||||
- Coordinate tools and knowledge
|
||||
|
||||
**Example:** cs-content-creator agent uses the content-creator skill's Python tools (brand_voice_analyzer.py, seo_optimizer.py) plus knowledge bases (brand guidelines, SEO frameworks) to guide you through content creation.
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
#### Task 5.2: Create INSTALL.md
|
||||
**GitHub Issue:** [#15 - Update project documentation](https://github.com/alirezarezvani/claude-skills/issues/15)
|
||||
**Estimated Time:** 45 minutes
|
||||
|
||||
**Contents:**
|
||||
- Prerequisites (Claude Code CLI, Python 3.8+, Git)
|
||||
- Installation steps (clone + manual setup until install.sh ready)
|
||||
- Verification commands
|
||||
- Troubleshooting section
|
||||
|
||||
---
|
||||
|
||||
#### Task 5.3: Create USAGE.md
|
||||
**GitHub Issue:** [#15 - Update project documentation](https://github.com/alirezarezvani/claude-skills/issues/15)
|
||||
**Estimated Time:** 1 hour
|
||||
|
||||
**Contents:**
|
||||
- Agent invocation examples (all 5 agents)
|
||||
- Multi-agent coordination patterns
|
||||
- Skill + Agent workflow examples
|
||||
- Best practices
|
||||
- Tips and tricks
|
||||
|
||||
---
|
||||
|
||||
#### Task 5.4: Update CLAUDE.md
|
||||
**GitHub Issue:** [#15 - Update project documentation](https://github.com/alirezarezvani/claude-skills/issues/15)
|
||||
**Estimated Time:** 30 minutes
|
||||
|
||||
**Updates:**
|
||||
- Architecture overview (new agents/ directory)
|
||||
- Directory tree diagram
|
||||
- Agent integration architecture section
|
||||
- cs-* prefix convention
|
||||
- Relative path patterns
|
||||
|
||||
---
|
||||
|
||||
### Day 6: Testing & Validation
|
||||
|
||||
#### Task 6.1: Comprehensive Testing
|
||||
**GitHub Issue:** [#16 - Phase 1-2 Testing and Validation](https://github.com/alirezarezvani/claude-skills/issues/16)
|
||||
**Estimated Time:** 2 hours
|
||||
|
||||
**Test Categories:**
|
||||
|
||||
1. **Directory Structure** (15 min)
|
||||
```bash
|
||||
# Verify all directories exist
|
||||
ls agents/marketing agents/c-level agents/product
|
||||
ls commands
|
||||
ls standards/communication standards/quality standards/git standards/documentation standards/security
|
||||
ls templates
|
||||
```
|
||||
|
||||
2. **Standards Validation** (15 min)
|
||||
```bash
|
||||
# Check all standards files
|
||||
ls standards/*/
|
||||
# Verify no factory references
|
||||
grep -r "rr-" standards/ || echo "✅ No rr-* references"
|
||||
grep -r "factory" standards/ || echo "✅ No factory references"
|
||||
# Markdown linting
|
||||
yamllint standards/
|
||||
```
|
||||
|
||||
3. **Agent Validation** (30 min)
|
||||
```bash
|
||||
# Check all agent files exist
|
||||
ls agents/marketing/cs-content-creator.md
|
||||
ls agents/marketing/cs-demand-gen-specialist.md
|
||||
ls agents/c-level/cs-ceo-advisor.md
|
||||
ls agents/c-level/cs-cto-advisor.md
|
||||
ls agents/product/cs-product-manager.md
|
||||
|
||||
# Validate YAML frontmatter (check each file)
|
||||
head -20 agents/marketing/cs-content-creator.md # Should show valid YAML
|
||||
```
|
||||
|
||||
4. **Path Resolution Testing** (30 min)
|
||||
```bash
|
||||
# Test from each agent directory
|
||||
cd agents/marketing
|
||||
python ../../marketing-skill/content-creator/scripts/brand_voice_analyzer.py --help
|
||||
ls ../../marketing-skill/content-creator/references/brand_guidelines.md
|
||||
|
||||
cd ../c-level
|
||||
ls ../../c-level-advisor/ceo-advisor/scripts/
|
||||
|
||||
cd ../product
|
||||
python ../../product-team/product-manager-toolkit/scripts/rice_prioritizer.py --help
|
||||
|
||||
cd ../..
|
||||
```
|
||||
|
||||
5. **Python Tool Execution** (30 min)
|
||||
```bash
|
||||
# Run actual tools to verify they work
|
||||
python marketing-skill/content-creator/scripts/brand_voice_analyzer.py CLAUDE.md
|
||||
|
||||
python marketing-skill/content-creator/scripts/seo_optimizer.py README.md "claude skills"
|
||||
|
||||
python product-team/product-manager-toolkit/scripts/rice_prioritizer.py --help
|
||||
```
|
||||
|
||||
6. **Documentation Quality** (15 min)
|
||||
```bash
|
||||
# Check for broken links
|
||||
# Verify markdown linting passes
|
||||
yamllint agents/**/*.md
|
||||
yamllint documentation/**/*.md
|
||||
|
||||
# Verify all required sections present in each agent
|
||||
grep -l "## Purpose" agents/**/*.md
|
||||
grep -l "## Skill Integration" agents/**/*.md
|
||||
grep -l "## Workflows" agents/**/*.md
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
#### Task 6.2: Quality Gates
|
||||
**Estimated Time:** 30 minutes
|
||||
|
||||
```bash
|
||||
# Run quality checks
|
||||
/review
|
||||
|
||||
# Run security scan
|
||||
/security-scan
|
||||
|
||||
# Verify all pass
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
#### Task 6.3: Final Validation Checklist
|
||||
**Estimated Time:** 15 minutes
|
||||
|
||||
- [ ] All 10 directories created
|
||||
- [ ] 5 standards files ported and validated
|
||||
- [ ] 5 agents implemented and tested
|
||||
- [ ] All relative paths work
|
||||
- [ ] All Python tools executable
|
||||
- [ ] Agent template complete
|
||||
- [ ] Creation guide actionable
|
||||
- [ ] README.md updated
|
||||
- [ ] INSTALL.md created
|
||||
- [ ] USAGE.md created
|
||||
- [ ] CLAUDE.md updated
|
||||
- [ ] All quality gates pass
|
||||
- [ ] No broken links
|
||||
|
||||
---
|
||||
|
||||
#### Task 6.4: Final Commit & PR
|
||||
**Estimated Time:** 30 minutes
|
||||
|
||||
```bash
|
||||
# Stage documentation
|
||||
git add README.md INSTALL.md USAGE.md CLAUDE.md
|
||||
|
||||
# Commit documentation
|
||||
git commit -m "docs: update project documentation for agent integration
|
||||
|
||||
- Update README with Quick Start and Agent Catalog
|
||||
- Create INSTALL.md with setup instructions
|
||||
- Create USAGE.md with comprehensive examples
|
||||
- Update CLAUDE.md with architecture changes
|
||||
|
||||
Phase: 4 (Documentation)
|
||||
Issue: #15"
|
||||
|
||||
# Push
|
||||
git push origin dev
|
||||
|
||||
# Create PR for review
|
||||
gh pr create \
|
||||
--base main \
|
||||
--head dev \
|
||||
--title "feat: Skill-Agent Integration Phase 1-2 Complete" \
|
||||
--body "$(cat <<'EOF'
|
||||
## Summary
|
||||
|
||||
Complete Phase 1-2 implementation of skill-agent integration for claude-code-skills.
|
||||
|
||||
## What's New
|
||||
|
||||
### Foundation (Phase 1)
|
||||
- ✅ Root-level directory structure (agents/, commands/, standards/, templates/)
|
||||
- ✅ 5 core standards ported from factory and adapted
|
||||
|
||||
### Agents (Phase 2)
|
||||
- ✅ cs-content-creator (marketing)
|
||||
- ✅ cs-demand-gen-specialist (marketing)
|
||||
- ✅ cs-ceo-advisor (C-level)
|
||||
- ✅ cs-cto-advisor (C-level)
|
||||
- ✅ cs-product-manager (product)
|
||||
|
||||
### Templates & Docs
|
||||
- ✅ Agent template for future expansion
|
||||
- ✅ Agent creation guide
|
||||
- ✅ Updated README, INSTALL, USAGE, CLAUDE
|
||||
|
||||
## Testing
|
||||
|
||||
- ✅ All relative paths resolve correctly
|
||||
- ✅ All Python tools execute successfully
|
||||
- ✅ Quality gates pass (/review, /security-scan)
|
||||
- ✅ No broken links
|
||||
- ✅ Comprehensive testing complete
|
||||
|
||||
## Issues Closed
|
||||
|
||||
Closes #8, #9, #11, #12, #13, #14, #15, #16
|
||||
|
||||
## Milestone
|
||||
|
||||
Completes: [Skill-Agent Integration v1.0](https://github.com/alirezarezvani/claude-skills/milestone/1) Phase 1-2
|
||||
|
||||
## Next Steps
|
||||
|
||||
- Phase 3: Installation scripts (install.sh, uninstall.sh)
|
||||
- Phase 4-5: Already complete (documentation & testing)
|
||||
- Phase 6-7: Plugin marketplace submission
|
||||
|
||||
## Reviewers
|
||||
|
||||
Please review:
|
||||
- [ ] Directory structure is clean
|
||||
- [ ] Agent implementations are comprehensive
|
||||
- [ ] Documentation is clear and actionable
|
||||
- [ ] All quality checks pass
|
||||
EOF
|
||||
)"
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
#### Task 6.5: Close All Issues
|
||||
**Estimated Time:** 15 minutes
|
||||
|
||||
```bash
|
||||
# Close remaining issues
|
||||
gh issue close 15 --comment "✅ All documentation updated (README, INSTALL, USAGE, CLAUDE)"
|
||||
gh issue close 16 --comment "✅ Comprehensive testing complete - all quality gates pass"
|
||||
|
||||
# Verify all closed
|
||||
gh issue list --milestone "Skill-Agent Integration v1.0" --state open
|
||||
# Should show 0 open issues for Phase 1-2
|
||||
```
|
||||
|
||||
**End of Day 6 Status:**
|
||||
- ✅ All documentation updated
|
||||
- ✅ Comprehensive testing complete
|
||||
- ✅ All quality gates pass
|
||||
- ✅ PR created for review
|
||||
- ✅ All Phase 1-2 issues closed
|
||||
|
||||
---
|
||||
|
||||
## Sprint Completion Summary
|
||||
|
||||
### Deliverables
|
||||
|
||||
**Phase 1: Foundation**
|
||||
- ✅ 10 directories created
|
||||
- ✅ 5 standards ported
|
||||
|
||||
**Phase 2: Agents**
|
||||
- ✅ 5 agents implemented
|
||||
- ✅ Agent template created
|
||||
- ✅ Creation guide written
|
||||
|
||||
**Phase 4: Documentation**
|
||||
- ✅ README updated
|
||||
- ✅ INSTALL.md created
|
||||
- ✅ USAGE.md created
|
||||
- ✅ CLAUDE.md updated
|
||||
|
||||
**Phase 5: Testing**
|
||||
- ✅ Comprehensive validation
|
||||
- ✅ All quality gates pass
|
||||
|
||||
### Metrics
|
||||
|
||||
- **Issues Completed:** 8 (all Phase 1-2 issues)
|
||||
- **Files Created:** 17 (10 dirs, 5 standards, 5 agents, 1 template, 1 guide, 4 docs)
|
||||
- **Lines of Code:** ~3000+ (agent files, documentation)
|
||||
- **Test Coverage:** 100% (all agents tested)
|
||||
- **Quality Score:** 100% (all gates pass)
|
||||
|
||||
### Next Sprint Planning
|
||||
|
||||
**Phase 3: Installation System**
|
||||
- Create install.sh (interactive)
|
||||
- Create uninstall.sh
|
||||
- Backwards compatibility
|
||||
|
||||
**Phase 6-7: Plugin Creation**
|
||||
- Research marketplace requirements
|
||||
- Design plugin.yaml manifest
|
||||
- Package for distribution
|
||||
- Submit to Anthropic marketplace
|
||||
|
||||
---
|
||||
|
||||
## Sprint Retrospective Notes
|
||||
|
||||
### What Went Well
|
||||
- Clear implementation plan
|
||||
- Comprehensive GitHub issues
|
||||
- Strong foundation established
|
||||
- Template enables future expansion
|
||||
|
||||
### Challenges Encountered
|
||||
- [To be filled during sprint]
|
||||
|
||||
### Lessons Learned
|
||||
- [To be filled during sprint]
|
||||
|
||||
### Process Improvements
|
||||
- [To be filled during sprint]
|
||||
|
||||
---
|
||||
|
||||
## References
|
||||
|
||||
- **Implementation Plan:** `documentation/implementation/implementation-plan-november-2025.md`
|
||||
- **Sprint Context:** `documentation/delivery/sprint-11-05-2025/context.md`
|
||||
- **GitHub Issues:** [#8](https://github.com/alirezarezvani/claude-skills/issues/8), [#9](https://github.com/alirezarezvani/claude-skills/issues/9), [#11](https://github.com/alirezarezvani/claude-skills/issues/11), [#12](https://github.com/alirezarezvani/claude-skills/issues/12), [#13](https://github.com/alirezarezvani/claude-skills/issues/13), [#14](https://github.com/alirezarezvani/claude-skills/issues/14), [#15](https://github.com/alirezarezvani/claude-skills/issues/15), [#16](https://github.com/alirezarezvani/claude-skills/issues/16)
|
||||
- **Milestone:** [Skill-Agent Integration v1.0](https://github.com/alirezarezvani/claude-skills/milestone/1)
|
||||
- **Project Board:** [Project #9](https://github.com/users/alirezarezvani/projects/9)
|
||||
|
||||
---
|
||||
|
||||
**Sprint Status:** 🎯 Ready to Start
|
||||
**Next Action:** Begin Day 1 - Task 1.1 (Create Directory Structure)
|
||||
**Document Version:** 1.0
|
||||
**Created:** November 5, 2025
|
||||
**Last Updated:** November 5, 2025
|
||||
Reference in New Issue
Block a user