e8af39aed6
- 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
239 lines
6.9 KiB
Markdown
239 lines
6.9 KiB
Markdown
# 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
|