firefrost-gaming/claude-skills-reference
3
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
d740f77ef74494dea032333894e335f6332cb423
claude-skills-reference/documentation/delivery/sprint-11-05-2025/context.md
Reza Rezvani e8af39aed6 feat(foundation): create directory structure and standards library 
- Create root-level directories: agents/, commands/, standards/, templates/
- Port 5 core standards from global Claude standards
- Adapt standards for claude-skills context (cs-* prefix, Python tools, skills)
- Create sprint planning documents (context.md, plan.md)
- All directories tracked with .gitkeep files

Standards created:
- communication-standards.md (absolute honesty, zero fluff, pragmatic focus)
- quality-standards.md (Python tool quality, agent workflows, testing)
- git-workflow-standards.md (conventional commits, semantic versioning)
- documentation-standards.md (Markdown standards, living docs, templates)
- security-standards.md (secret detection, dependency security, input validation)

Sprint plan ready for Days 1-6 implementation.

Phase: 1 (Foundation)
Issues: #8, #9
2025-11-05 11:37:53 +01:00

6.9 KiB
Raw Blame History

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
  • Project Board: Project #9: @claude-code-skills
  • 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

Reference in New Issue View Git Blame Copy Permalink