agcel 1.0.1

package/.agent/workflows/commit.md

@@ -0,0 +1,223 @@
+# /commit - Smart Commit Command
+
+## Purpose
+
+Create a well-formatted commit with auto-generated message based on staged changes.
+
+## Usage
+
+```
+/commit [optional message hint]
+```
+
+## Arguments
+
+- `$ARGUMENTS`: Optional hint for commit message focus (e.g., "auth", "bugfix", "refactor")
+
+---
+
+Create a commit for staged changes with hint: **$ARGUMENTS**
+
+## Workflow
+
+### Step 1: Analyze Changes
+
+1. **Check Status**
+   ```bash
+   git status
+   ```
+
+2. **View Staged Changes**
+   ```bash
+   git diff --staged
+   ```
+
+3. **Review Recent Commits**
+   ```bash
+   git log --oneline -5
+   ```
+
+### Step 2: Categorize Changes
+
+Determine commit type:
+- `feat`: New feature
+- `fix`: Bug fix
+- `docs`: Documentation
+- `style`: Formatting
+- `refactor`: Code restructuring
+- `test`: Adding tests
+- `chore`: Maintenance
+
+### Step 3: Generate Message
+
+Follow conventional commit format:
+```
+type(scope): subject
+
+body (optional)
+
+footer (optional)
+```
+
+### Step 4: Create Commit
+
+```bash
+git commit -m "$(cat <<'EOF'
+type(scope): subject
+
+- Change 1
+- Change 2
+
+🤖 Generated with [Claude Code](https://claude.com/claude-code)
+
+Co-Authored-By: Claude <noreply@anthropic.com>
+EOF
+)"
+```
+
+## Commit Message Guidelines
+
+### Subject Line
+- Max 50 characters
+- Imperative mood ("Add" not "Added")
+- No period at end
+- Capitalize first letter
+
+### Body
+- Wrap at 72 characters
+- Explain what and why
+- Use bullet points for multiple changes
+
+### Examples
+
+#### Feature
+```
+feat(auth): add password reset functionality
+
+- Add reset token generation
+- Implement email sending
+- Add rate limiting for reset requests
+
+Closes #123
+```
+
+#### Bug Fix
+```
+fix(api): handle null user in profile endpoint
+
+The profile endpoint crashed when accessing deleted users.
+Added null check and proper 404 response.
+
+Fixes #456
+```
+
+#### Refactor
+```
+refactor(database): extract query builders
+
+Split large database service into focused modules
+for better maintainability and testing.
+```
+
+#### Documentation
+```
+docs(readme): update installation instructions
+
+- Add prerequisites section
+- Update configuration examples
+- Fix broken links
+```
+
+#### Test
+```
+test(auth): add missing login tests
+
+- Add test for invalid credentials
+- Add test for locked account
+- Add test for expired session
+```
+
+#### Chore
+```
+chore(deps): update dependencies
+
+- Update React to 18.2
+- Update TypeScript to 5.3
+- Remove unused packages
+```
+
+## Output
+
+### Commit Created
+
+```markdown
+## Commit Created
+
+**Hash**: `abc1234`
+**Branch**: `feature/auth-improvements`
+
+### Message
+```
+feat(auth): add OAuth2 login support
+
+- Implement Google OAuth provider
+- Implement GitHub OAuth provider
+- Add session token generation
+- Update user model for OAuth data
+
+Closes #789
+```
+
+### Files Changed
+| Status | File |
+|--------|------|
+| M | src/auth/providers.ts |
+| A | src/auth/oauth/google.ts |
+| A | src/auth/oauth/github.ts |
+| M | src/models/user.ts |
+| A | tests/auth/oauth.test.ts |
+
+### Stats
+- 5 files changed
+- 234 insertions(+)
+- 12 deletions(-)
+
+### Next Steps
+```bash
+# Push to remote
+git push -u origin feature/auth-improvements
+
+# Create PR
+gh pr create
+```
+```
+
+## Pre-Commit Checks
+
+Before committing:
+- [ ] No secrets in staged files
+- [ ] No debug statements
+- [ ] No TODO comments (unless intentional)
+- [ ] Code is formatted
+
+## Amending Commits
+
+If pre-commit hooks modify files:
+```bash
+# Stage modified files and amend
+git add -A
+git commit --amend --no-edit
+```
+
+<!-- CUSTOMIZATION POINT -->
+## Variations
+
+Modify behavior via CLAUDE.md:
+- Commit message format
+- Required sections
+- Issue reference format
+- Co-author settings
+
+
+## Gap Analysis Rule
+Always identify gaps and suggest next steps to users. In case there is no gaps anymore, then AI should clearly state that there is no gap left.

package/.agent/workflows/debug.md

@@ -0,0 +1,57 @@
+# /debug - Debug Command
+
+## Purpose
+
+Analyze and debug an error, exception, or unexpected behavior.
+
+## Usage
+
+```
+/debug [error message or description]
+```
+
+---
+
+Debug issue: **$ARGUMENTS**
+
+## Workflow
+
+### Step 1: Analyze Error
+
+1. Parse error message and stack trace
+2. Identify error location
+3. Understand error type
+
+### Step 2: Investigate
+
+1. Trace execution path
+2. Check related code
+3. Form hypotheses
+
+### Step 3: Fix
+
+1. Implement minimal fix
+2. Verify fix works
+3. Add regression test
+
+## Output
+
+```markdown
+## Debug Report
+
+### Error
+[Error message]
+
+### Root Cause
+[Explanation]
+
+### Fix
+[Code changes]
+
+### Prevention
+[Test added]
+```
+
+
+## Gap Analysis Rule
+Always identify gaps and suggest next steps to users. In case there is no gaps anymore, then AI should clearly state that there is no gap left.

package/.agent/workflows/deploy.md

@@ -0,0 +1,76 @@
+# /deploy - Deployment Command
+
+## Purpose
+
+Deploy the application to a specified environment with proper checks.
+
+## Usage
+
+```
+/deploy [environment: staging | production]
+```
+
+---
+
+Deploy to: **$ARGUMENTS**
+
+## Workflow
+
+### Pre-Deploy Checks
+
+1. **Verify Build**
+   ```bash
+   pnpm build
+   ```
+
+2. **Run Tests**
+   ```bash
+   pnpm test
+   ```
+
+3. **Security Scan**
+   ```bash
+   npm audit --audit-level=high
+   ```
+
+### Deploy
+
+1. **Staging**
+   ```bash
+   # Deploy to staging environment
+   ```
+
+2. **Production** (requires confirmation)
+   ```bash
+   # Deploy to production environment
+   ```
+
+### Post-Deploy
+
+1. **Verify Deployment**
+   - Health checks
+   - Smoke tests
+
+2. **Monitor**
+   - Check logs
+   - Watch metrics
+
+## Output
+
+```markdown
+## Deployment Complete
+
+**Environment**: staging
+**Version**: v1.2.3
+**URL**: https://staging.example.com
+
+### Checks
+- [x] Build successful
+- [x] Tests passing
+- [x] Security scan clean
+- [x] Health check passed
+```
+
+
+## Gap Analysis Rule
+Always identify gaps and suggest next steps to users. In case there is no gaps anymore, then AI should clearly state that there is no gap left.

package/.agent/workflows/doc.md

@@ -0,0 +1,247 @@
+# /doc - Documentation Command
+
+## Purpose
+
+Generate or update documentation including API docs, README files, code comments, and technical specifications.
+
+## Usage
+
+```
+/doc [target | 'api' | 'readme' | 'changelog']
+```
+
+## Arguments
+
+- `$ARGUMENTS`:
+  - File/function path: Document specific code
+  - `api`: Generate API documentation
+  - `readme`: Update README file
+  - `changelog`: Generate changelog from commits
+
+---
+
+Generate documentation for: **$ARGUMENTS**
+
+## Workflow
+
+### For Code Documentation
+
+1. **Analyze Code**
+   - Read the code thoroughly
+   - Understand purpose and behavior
+   - Identify inputs and outputs
+   - Note side effects
+
+2. **Generate Documentation**
+   - Add docstrings/JSDoc
+   - Include examples
+   - Document edge cases
+   - Add type annotations
+
+### For API Documentation
+
+1. **Find All Endpoints**
+   - Scan route definitions
+   - Identify HTTP methods
+   - Note authentication requirements
+
+2. **Document Each Endpoint**
+   - Request format
+   - Response format
+   - Error responses
+   - Examples
+
+### For README
+
+1. **Analyze Project**
+   - Purpose and features
+   - Installation steps
+   - Usage examples
+   - Configuration
+
+2. **Generate/Update**
+   - Clear structure
+   - Working examples
+   - Up-to-date info
+
+### For Changelog
+
+1. **Analyze Commits**
+   ```bash
+   git log --oneline --since="last release"
+   ```
+
+2. **Categorize Changes**
+   - Added
+   - Changed
+   - Fixed
+   - Removed
+
+## Templates
+
+### Python Docstring
+```python
+def calculate_discount(price: float, percentage: float) -> float:
+    """
+    Calculate discounted price.
+
+    Args:
+        price: Original price in dollars.
+        percentage: Discount percentage (0-100).
+
+    Returns:
+        The discounted price.
+
+    Raises:
+        ValueError: If percentage is not between 0 and 100.
+
+    Example:
+        >>> calculate_discount(100.0, 20)
+        80.0
+    """
+```
+
+### TypeScript JSDoc
+```typescript
+/**
+ * Calculate discounted price.
+ *
+ * @param price - Original price in dollars
+ * @param percentage - Discount percentage (0-100)
+ * @returns The discounted price
+ * @throws {RangeError} If percentage is not between 0 and 100
+ *
+ * @example
+ * calculateDiscount(100, 20); // returns 80
+ */
+```
+
+### API Endpoint
+```markdown
+## POST /api/orders
+
+Create a new order.
+
+### Authentication
+Requires Bearer token.
+
+### Request Body
+```json
+{
+  "items": [
+    { "productId": "123", "quantity": 2 }
+  ],
+  "shippingAddress": {
+    "street": "123 Main St",
+    "city": "New York",
+    "zip": "10001"
+  }
+}
+```
+
+### Response (201 Created)
+```json
+{
+  "id": "order_456",
+  "status": "pending",
+  "total": 99.99,
+  "createdAt": "2024-01-15T10:00:00Z"
+}
+```
+
+### Errors
+| Status | Code | Description |
+|--------|------|-------------|
+| 400 | INVALID_ITEMS | Items array is empty |
+| 401 | UNAUTHORIZED | Invalid or missing token |
+| 422 | OUT_OF_STOCK | Item not available |
+```
+
+### README Section
+```markdown
+## Installation
+
+```bash
+npm install my-package
+```
+
+## Quick Start
+
+```typescript
+import { Client } from 'my-package';
+
+const client = new Client({ apiKey: 'your-key' });
+const result = await client.fetch();
+```
+
+## Configuration
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `apiKey` | string | required | Your API key |
+| `timeout` | number | 5000 | Request timeout in ms |
+```
+
+### Changelog Entry
+```markdown
+## [1.2.0] - 2024-01-15
+
+### Added
+- Password reset functionality (#123)
+- Email verification for new accounts
+
+### Changed
+- Improved error messages for validation failures
+- Updated dependencies to latest versions
+
+### Fixed
+- Race condition in session handling (#456)
+- Incorrect timezone in date displays
+```
+
+## Output
+
+### Documentation Report
+
+```markdown
+## Documentation Updated
+
+### Files Modified
+- `src/services/auth.ts` - Added JSDoc comments
+- `docs/api/auth.md` - New API documentation
+- `README.md` - Updated configuration section
+
+### Documentation Added
+
+#### Code Comments
+- `AuthService.login()` - Full JSDoc with examples
+- `AuthService.logout()` - Parameter documentation
+- `validateToken()` - Return type and exceptions
+
+#### API Documentation
+- POST /api/auth/login
+- POST /api/auth/logout
+- POST /api/auth/refresh
+
+### Coverage
+- Functions documented: 15/18 (83%)
+- Endpoints documented: 12/12 (100%)
+
+### Next Steps
+1. Add examples to remaining functions
+2. Create getting started guide
+3. Add architecture diagram
+```
+
+<!-- CUSTOMIZATION POINT -->
+## Variations
+
+Modify behavior via CLAUDE.md:
+- Documentation format
+- Required sections
+- Example requirements
+- API documentation tool
+
+
+## Gap Analysis Rule
+Always identify gaps and suggest next steps to users. In case there is no gaps anymore, then AI should clearly state that there is no gap left.