create-claude-context 1.0.0

package/templates/base/standards/QUALITY_CHECKLIST.md

@@ -0,0 +1,211 @@
+# Quality Checklist
+
+Use this checklist to ensure your Claude Context Engineering implementation meets quality standards.
+
+## For Projects Using the Template
+
+### Initial Setup
+
+- [ ] All `{{PLACEHOLDER}}` values replaced with project-specific content
+- [ ] CLAUDE.md customized for your codebase
+- [ ] Tech stack correctly identified
+- [ ] File paths in documentation are accurate
+- [ ] Line numbers in code references are current
+
+### Documentation Quality
+
+- [ ] INDEX files reflect actual directory structure
+- [ ] Workflow documents describe real system behavior
+- [ ] Architecture snapshot matches current architecture
+- [ ] Known gotchas are documented and current
+- [ ] Code-to-workflow map is accurate
+
+### Context Budget
+
+- [ ] Total documentation under 40% of context budget (~80K tokens)
+- [ ] No single file exceeds 10K tokens
+- [ ] Indexes are concise pointers, not content dumps
+- [ ] Rarely-used content in separate files
+
+### Validation
+
+- [ ] `npx claude-context validate --all` passes
+- [ ] All internal links resolve
+- [ ] JSON files pass schema validation
+- [ ] No broken file references
+
+---
+
+## For Extension Authors
+
+### Structure
+
+- [ ] `manifest.json` present and valid
+- [ ] `README.md` complete with all sections
+- [ ] `LICENSE` file included
+- [ ] `CHANGELOG.md` documents version history
+- [ ] Directory structure follows convention
+
+### Manifest
+
+- [ ] `name` is lowercase with hyphens only
+- [ ] `version` follows semver (MAJOR.MINOR.PATCH)
+- [ ] `description` is under 200 characters
+- [ ] `author` information complete
+- [ ] `license` is valid SPDX identifier
+- [ ] `claude_context_version` specifies compatibility
+- [ ] `contents` lists all provided components
+
+### Documentation
+
+- [ ] Installation instructions clear and tested
+- [ ] All components documented with examples
+- [ ] Configuration requirements specified
+- [ ] Troubleshooting section included
+- [ ] No placeholder text remains
+
+### Code Quality
+
+- [ ] Agents follow frontmatter schema
+- [ ] Commands follow frontmatter schema
+- [ ] Workflows follow workflow schema
+- [ ] All required metadata present
+- [ ] Context budgets documented
+
+### Testing
+
+- [ ] Installs without errors
+- [ ] All examples work as documented
+- [ ] No conflicts with base template
+- [ ] Tested with specified template version
+
+### Security
+
+- [ ] No hardcoded secrets or API keys
+- [ ] No personal data included
+- [ ] External calls documented
+- [ ] File operations are safe
+- [ ] License is compatible
+
+---
+
+## For Template Contributors
+
+### Code Changes
+
+- [ ] Follows existing code style
+- [ ] Includes appropriate tests
+- [ ] Documentation updated
+- [ ] CHANGELOG entry added
+- [ ] Breaking changes documented
+
+### Schema Changes
+
+- [ ] Schema version incremented
+- [ ] Migration path documented
+- [ ] Backward compatibility considered
+- [ ] Examples updated
+
+### Documentation Changes
+
+- [ ] Links verified
+- [ ] Line numbers updated
+- [ ] Consistent formatting
+- [ ] Grammar and spelling checked
+
+### Pull Request
+
+- [ ] Clear description of changes
+- [ ] Issue reference (if applicable)
+- [ ] Tests passing
+- [ ] Documentation updated
+- [ ] CHANGELOG updated
+
+---
+
+## Validation Commands
+
+Run these commands to validate your implementation:
+
+```bash
+# Full validation suite
+npx claude-context validate --all
+
+# Specific validations
+npx claude-context validate --schema      # JSON schemas
+npx claude-context validate --links       # Internal links
+npx claude-context validate --placeholders # Unreplaced placeholders
+npx claude-context validate --structure   # Directory structure
+npx claude-context validate --lines       # Line number accuracy
+
+# Diagnostics
+npx claude-context diagnose               # System health check
+npx claude-context diagnose --fix         # Auto-fix issues
+```
+
+## Quality Levels
+
+### Level 1: Minimal (Required)
+
+- All placeholders replaced
+- Basic documentation present
+- Validation passes
+- No broken links
+
+### Level 2: Standard (Recommended)
+
+- Complete documentation
+- Accurate line numbers (>60%)
+- Context budget under 40%
+- Regular validation in CI
+
+### Level 3: Exemplary (Best Practice)
+
+- Comprehensive documentation
+- Line accuracy >80%
+- Context budget under 30%
+- Automated documentation updates
+- Full CI/CD integration
+
+## Common Issues
+
+### Placeholder Not Replaced
+
+**Symptom:** `{{PLACEHOLDER}}` appears in output
+
+**Fix:** Search for all `{{` patterns and replace:
+```bash
+grep -r "{{" .claude/
+```
+
+### Broken Internal Link
+
+**Symptom:** Link validation fails
+
+**Fix:** Update link path or create missing file:
+```bash
+npx claude-context validate --links --verbose
+```
+
+### Context Budget Exceeded
+
+**Symptom:** Documentation >40% of budget
+
+**Fix:**
+1. Split large files
+2. Move details to separate files
+3. Compact verbose sections
+
+### Line Number Drift
+
+**Symptom:** Code references point to wrong lines
+
+**Fix:**
+```bash
+npx claude-context diagnose --fix
+```
+
+## Related
+
+- [Extension Guidelines](./EXTENSION_GUIDELINES.md)
+- [Compatibility Guide](./COMPATIBILITY.md)

package/templates/base/standards/README.md

@@ -0,0 +1,66 @@
+# Standards
+
+Quality standards, guidelines, and compatibility information for Claude Context Engineering.
+
+## Contents
+
+| Document | Description |
+|----------|-------------|
+| [EXTENSION_GUIDELINES.md](./EXTENSION_GUIDELINES.md) | How to create and publish extensions |
+| [QUALITY_CHECKLIST.md](./QUALITY_CHECKLIST.md) | Quality requirements and validation checklist |
+| [COMPATIBILITY.md](./COMPATIBILITY.md) | Version compatibility and migration information |
+
+## Quick Reference
+
+### For Users
+
+Use the [Quality Checklist](./QUALITY_CHECKLIST.md) to ensure your implementation meets standards:
+
+```bash
+# Run full validation
+npx claude-context validate --all
+```
+
+### For Extension Authors
+
+Follow the [Extension Guidelines](./EXTENSION_GUIDELINES.md) to create publishable extensions:
+
+1. Structure your extension correctly
+2. Include required manifest and documentation
+3. Meet quality requirements
+4. Submit for review
+
+### For Contributors
+
+Check [Compatibility](./COMPATIBILITY.md) when making changes:
+
+- Follow semantic versioning
+- Document breaking changes
+- Provide migration paths
+
+## Standards Summary
+
+### Quality Levels
+
+| Level | Requirements |
+|-------|--------------|
+| Minimal | Placeholders replaced, validation passes |
+| Standard | Complete documentation, <40% context budget |
+| Exemplary | >80% accuracy, <30% budget, CI integration |
+
+### Extension Requirements
+
+| Requirement | Status |
+|-------------|--------|
+| manifest.json | Required |
+| README.md | Required |
+| LICENSE | Required |
+| CHANGELOG.md | Recommended |
+| Tests | Recommended |
+
+### Version Compatibility
+
+- Use `^1.0.0` for extension compatibility ranges
+- Major version = breaking changes
+- Minor version = new features
+- Patch version = bug fixes

package/templates/base/team/README.md

@@ -0,0 +1,168 @@
+# Team Collaboration
+
+Configuration and setup for team-based Claude Code collaboration.
+
+## Overview
+
+This directory contains team configuration that enables:
+- Multi-user collaboration on Claude Code sessions
+- Role-based access control
+- Session handoffs between team members
+- Shared knowledge synchronization
+- Team notifications and integrations
+
+## Quick Setup
+
+### 1. Configure Team
+
+Edit `config.json` and replace placeholders:
+
+```json
+{
+  "team": {
+    "name": "Your Team Name",
+    "organization": "Your Organization"
+  }
+}
+```
+
+### 2. Add Team Members
+
+Add members to the `members` array in `config.json`:
+
+```json
+{
+  "members": [
+    {
+      "id": "unique-id",
+      "name": "Developer Name",
+      "role": "developer",
+      "email": "dev@example.com",
+      "permissions": ["read", "write", "execute"],
+      "active": true
+    }
+  ]
+}
+```
+
+### 3. Assign Roles
+
+Available roles (defined in `roles.json`):
+
+| Role | Description | Key Permissions |
+|------|-------------|-----------------|
+| `team-lead` | Full access, manages team | All permissions |
+| `senior-developer` | Development + approvals | read, write, execute, approve |
+| `developer` | Standard development | read, write, execute |
+| `reviewer` | Code review focus | read, approve |
+| `observer` | Read-only access | read |
+
+### 4. Configure Integrations (Optional)
+
+#### Slack Notifications
+
+```json
+{
+  "notifications": {
+    "enabled": true,
+    "channels": {
+      "slack": {
+        "webhook_url": "https://hooks.slack.com/...",
+        "channel": "#claude-notifications"
+      }
+    }
+  }
+}
+```
+
+#### Jira Integration
+
+```json
+{
+  "integrations": {
+    "jira": {
+      "enabled": true,
+      "project_key": "PROJ",
+      "api_url": "https://your-domain.atlassian.net"
+    }
+  }
+}
+```
+
+## Files
+
+| File | Purpose |
+|------|---------|
+| `config.json` | Team settings, members, integrations |
+| `roles.json` | Role definitions and permissions |
+
+## Usage
+
+### Session Handoffs
+
+When ending a session, create a handoff document:
+
+```
+/collab handoff
+```
+
+This generates a session summary in `.claude/knowledge/sessions/` for the next team member.
+
+### Sync Shared Knowledge
+
+Synchronize team knowledge base:
+
+```
+/collab sync
+```
+
+### Check Team Status
+
+View team configuration and active sessions:
+
+```
+/collab status
+```
+
+## Policies
+
+Configure team policies in `config.json`:
+
+```json
+{
+  "policies": {
+    "code_review_required": true,
+    "documentation_update_required": true,
+    "test_coverage_minimum": 80,
+    "max_file_changes_per_session": 50
+  }
+}
+```
+
+## Security Notes
+
+- `config.json` may contain sensitive webhooks - consider gitignoring
+- Use environment variables for API tokens
+- Review member permissions regularly
+- Session handoffs may contain context - handle appropriately
+
+## Troubleshooting
+
+### Member not recognized
+
+Ensure the member entry in `config.json` has:
+- Unique `id`
+- Valid `role` matching `roles.json`
+- `active: true`
+
+### Notifications not sending
+
+1. Verify webhook URL is correct
+2. Check `notifications.enabled` is `true`
+3. Ensure event type is enabled in `notifications.events`
+
+### Permission denied
+
+1. Check member's role in `config.json`
+2. Verify role has required permission in `roles.json`
+3. Ensure member is `active: true`

package/templates/base/team/config.json

@@ -0,0 +1,79 @@
+{
+  "$schema": "../schemas/team-config.schema.json",
+  "$comment": "Team configuration for collaborative Claude Code sessions",
+
+  "team": {
+    "name": "{{TEAM_NAME}}",
+    "organization": "{{ORGANIZATION_NAME}}",
+    "created": "{{DATE}}",
+    "version": "1.0.0"
+  },
+
+  "members": [
+    {
+      "id": "lead-1",
+      "name": "{{TEAM_LEAD_NAME}}",
+      "role": "team-lead",
+      "email": "{{TEAM_LEAD_EMAIL}}",
+      "permissions": ["all"],
+      "active": true
+    },
+    {
+      "id": "dev-1",
+      "name": "{{DEVELOPER_1_NAME}}",
+      "role": "developer",
+      "email": "{{DEVELOPER_1_EMAIL}}",
+      "permissions": ["read", "write", "execute"],
+      "active": true
+    }
+  ],
+
+  "settings": {
+    "require_handoff_on_session_end": true,
+    "auto_sync_knowledge": true,
+    "shared_context_enabled": true,
+    "session_timeout_minutes": 480,
+    "max_concurrent_sessions": 5
+  },
+
+  "notifications": {
+    "enabled": false,
+    "channels": {
+      "slack": {
+        "webhook_url": "{{SLACK_WEBHOOK_URL}}",
+        "channel": "#claude-notifications"
+      },
+      "email": {
+        "smtp_configured": false
+      }
+    },
+    "events": {
+      "session_handoff": true,
+      "knowledge_update": true,
+      "error_critical": true
+    }
+  },
+
+  "integrations": {
+    "git": {
+      "auto_attribute_commits": true,
+      "co_author_format": "Co-Authored-By: {{MEMBER_NAME}} <{{MEMBER_EMAIL}}>"
+    },
+    "jira": {
+      "enabled": false,
+      "project_key": "{{JIRA_PROJECT_KEY}}",
+      "api_url": "{{JIRA_API_URL}}"
+    },
+    "confluence": {
+      "enabled": false,
+      "space_key": "{{CONFLUENCE_SPACE_KEY}}"
+    }
+  },
+
+  "policies": {
+    "code_review_required": true,
+    "documentation_update_required": true,
+    "test_coverage_minimum": 80,
+    "max_file_changes_per_session": 50
+  }
+}

package/templates/base/team/roles.json

@@ -0,0 +1,145 @@
+{
+  "$schema": "../schemas/roles.schema.json",
+  "$comment": "Role definitions for team collaboration",
+
+  "roles": {
+    "team-lead": {
+      "displayName": "Team Lead",
+      "description": "Full access to all features, manages team settings and approvals",
+      "permissions": [
+        "read",
+        "write",
+        "execute",
+        "approve",
+        "configure",
+        "manage-members",
+        "manage-knowledge",
+        "manage-sessions"
+      ],
+      "capabilities": {
+        "can_approve_plans": true,
+        "can_modify_team_config": true,
+        "can_add_members": true,
+        "can_remove_members": true,
+        "can_access_all_sessions": true,
+        "can_override_policies": true
+      },
+      "context_access": {
+        "shared_knowledge": "full",
+        "session_history": "all",
+        "sensitive_configs": true
+      }
+    },
+
+    "senior-developer": {
+      "displayName": "Senior Developer",
+      "description": "Full development access with plan approval capabilities",
+      "permissions": [
+        "read",
+        "write",
+        "execute",
+        "approve"
+      ],
+      "capabilities": {
+        "can_approve_plans": true,
+        "can_modify_team_config": false,
+        "can_add_members": false,
+        "can_remove_members": false,
+        "can_access_all_sessions": true,
+        "can_override_policies": false
+      },
+      "context_access": {
+        "shared_knowledge": "full",
+        "session_history": "team",
+        "sensitive_configs": false
+      }
+    },
+
+    "developer": {
+      "displayName": "Developer",
+      "description": "Standard development access for implementing features and fixes",
+      "permissions": [
+        "read",
+        "write",
+        "execute"
+      ],
+      "capabilities": {
+        "can_approve_plans": false,
+        "can_modify_team_config": false,
+        "can_add_members": false,
+        "can_remove_members": false,
+        "can_access_all_sessions": false,
+        "can_override_policies": false
+      },
+      "context_access": {
+        "shared_knowledge": "full",
+        "session_history": "own",
+        "sensitive_configs": false
+      }
+    },
+
+    "reviewer": {
+      "displayName": "Code Reviewer",
+      "description": "Read access with approval capabilities for code review",
+      "permissions": [
+        "read",
+        "approve"
+      ],
+      "capabilities": {
+        "can_approve_plans": true,
+        "can_modify_team_config": false,
+        "can_add_members": false,
+        "can_remove_members": false,
+        "can_access_all_sessions": true,
+        "can_override_policies": false
+      },
+      "context_access": {
+        "shared_knowledge": "read-only",
+        "session_history": "team",
+        "sensitive_configs": false
+      }
+    },
+
+    "observer": {
+      "displayName": "Observer",
+      "description": "Read-only access for monitoring and learning",
+      "permissions": [
+        "read"
+      ],
+      "capabilities": {
+        "can_approve_plans": false,
+        "can_modify_team_config": false,
+        "can_add_members": false,
+        "can_remove_members": false,
+        "can_access_all_sessions": false,
+        "can_override_policies": false
+      },
+      "context_access": {
+        "shared_knowledge": "read-only",
+        "session_history": "none",
+        "sensitive_configs": false
+      }
+    }
+  },
+
+  "permission_definitions": {
+    "read": "View files, documentation, and session history",
+    "write": "Create and modify files, documentation",
+    "execute": "Run commands, scripts, and Claude Code operations",
+    "approve": "Approve plans, pull requests, and changes",
+    "configure": "Modify project and team configuration",
+    "manage-members": "Add, remove, and modify team members",
+    "manage-knowledge": "Create, edit, and delete shared knowledge",
+    "manage-sessions": "Access and manage all team sessions"
+  },
+
+  "default_role": "developer",
+
+  "role_hierarchy": [
+    "team-lead",
+    "senior-developer",
+    "developer",
+    "reviewer",
+    "observer"
+  ]
+}