@thatix.io/context-first-agents-cli 0.1.0 → 0.2.0

package/dist/templates/commands/en/engineer/pr.md

@@ -0,0 +1,194 @@
+# Pull Request Creation
+
+This command creates Pull Requests for all modified repositories in the workspace.
+
+## 📋 Prerequisites
+
+Before creating PRs, make sure that:
+- You have run `/pre-pr` and all validations passed
+- All commits have been made
+- All tests are passing
+- Documentation is up to date
+
+## Configuration
+
+Read `context-manifest.json` and `ai.properties.md` from the orchestrator to get repositories, base_path, and task_management_system.
+
+## 🛑 CRITICAL: WHERE TO WORK
+
+**⚠️ ATTENTION: If you need to make last-minute adjustments, ALL CODE MUST BE CREATED INSIDE THE WORKTREE!**
+
+**✅ CORRECT** - Work inside the worktree:
+```
+<orchestrator>/.sessions/<ISSUE-ID>/<repo-name>/src/file.ts  ✅
+<orchestrator>/.sessions/<ISSUE-ID>/<repo-name>/README.md  ✅
+<orchestrator>/.sessions/<ISSUE-ID>/<repo-name>/CHANGELOG.md  ✅
+```
+
+**❌ WRONG** - NEVER create code outside the worktree:
+```
+<orchestrator>/.sessions/file.ts  ❌
+<orchestrator>/.sessions/<ISSUE-ID>/file.ts  ❌
+{base_path}/<repo-name>/file.ts  ❌ (main repository!)
+```
+
+**ABSOLUTE RULE**:
+- 🛑 **Any code adjustment** (docs, changelog, fixes) **MUST be in** `<orchestrator>/.sessions/<ISSUE-ID>/<repo-name>/`
+- 🛑 **NEVER modify** the main repository at `{base_path}/<repo-name>/`
+- ✅ **Work ONLY** inside the worktree of the specific repository
+
+## 🎯 PR Creation Process
+
+### 1. Identify Modified Repositories
+
+For each repository in the workspace, check:
+```bash
+cd <repository>
+git status
+git log origin/main..HEAD  # See unpushed commits
+```
+
+### 2. Push Branches
+
+For each modified repository:
+```bash
+cd <repository>
+git push origin <branch-name>
+```
+
+### 3. Create Pull Requests
+
+For each repository, create a PR using GitHub CLI or web interface:
+
+**Using GitHub CLI**:
+```bash
+cd <repository>
+gh pr create --title "[ISSUE-ID] Feature Title" \
+  --body "$(cat ../.sessions/<ISSUE-ID>/pr-description.md)" \
+  --base main
+```
+
+**PR Description Template**:
+
+```markdown
+## 🎯 Objective
+
+[Brief description of what this PR does]
+
+## 📝 Changes
+
+### Repository: <repo-name>
+
+- [Change 1]
+- [Change 2]
+- [Change 3]
+
+## 🔗 Relationships
+
+- **Issue**: <ISSUE-ID>
+- **Related PRs**:
+  - <repo-1>#<PR-number>
+  - <repo-2>#<PR-number>
+
+## ✅ Checklist
+
+- [ ] Code implemented and tested
+- [ ] Unit tests added/updated
+- [ ] Integration tests passing
+- [ ] Documentation updated
+- [ ] No breaking changes (or documented)
+- [ ] Peer reviewed (after PR creation)
+
+## 🧪 How to Test
+
+1. [Step 1]
+2. [Step 2]
+3. [Expected result]
+
+## 📸 Screenshots/Demos
+
+[If applicable, add screenshots or links to demos]
+
+## 🔍 Notes for Reviewers
+
+- [Point of attention 1]
+- [Point of attention 2]
+```
+
+### 4. Link PRs
+
+If there are multiple PRs (one per repository):
+- Add cross-links between PRs
+- Document the recommended merge order
+- Indicate dependencies between PRs
+
+### 5. Update Issue in Task Manager
+
+If task manager is configured:
+- Move the issue to "In Review" or "PR Open"
+- Add PR links to the issue
+- Add a comment summarizing the changes
+
+### 6. Session Documentation
+
+Update `./.sessions/<ISSUE-ID>/pr.md`:
+
+```markdown
+# [Feature Title] - Pull Requests
+
+## Created PRs
+
+### <repo-1>
+- **Link**: <PR URL>
+- **Status**: Open
+- **Commits**: X commits
+
+### <repo-2>
+- **Link**: <PR URL>
+- **Status**: Open
+- **Commits**: Y commits
+
+## Recommended Merge Order
+
+1. <repo-1> - [Justification]
+2. <repo-2> - [Justification]
+
+## Merge Notes
+
+- [Important note 1]
+- [Important note 2]
+```
+
+## 🔍 Final Checklist
+
+Before requesting review:
+- [ ] All PRs created
+- [ ] Complete and clear descriptions
+- [ ] PRs linked to each other
+- [ ] Issue updated in task manager
+- [ ] Tests passing in CI/CD
+- [ ] Complete session documentation
+
+## 📢 Communication
+
+Notify the team about the PRs:
+- Mention relevant reviewers
+- Highlight critical or breaking changes
+- Indicate urgency if applicable
+
+---
+
+**Provided arguments**:
+
+```
+#$ARGUMENTS
+```
+
+---
+
+## 🎯 Next Steps
+
+1. Await PR reviews
+2. Respond to comments and make adjustments
+3. After approval, merge in the recommended order
+4. Run `context-cli feature:end <ISSUE-ID>` to clean the workspace

package/dist/templates/commands/en/engineer/pre-pr.md

@@ -0,0 +1,325 @@
+# Pull Request Preparation
+
+This command validates that everything is ready to create Pull Requests.
+
+## 📋 Prerequisites
+
+- Complete implementation (all tasks from `/plan` executed)
+- All commits made
+- Clean and organized workspace
+
+## Configuration
+
+Read `context-manifest.json` and `ai.properties.md` from the orchestrator to get repositories, base_path, and task_management_system.
+
+## 🎯 Objective
+
+Ensure that the implementation is complete, tested, and ready for review before creating PRs.
+
+## 🛑 CRITICAL: WHERE TO WORK
+
+**⚠️ ATTENTION: ALL CODE (tests, fixes, adjustments) MUST BE CREATED INSIDE THE WORKTREE!**
+
+**✅ CORRECT** - Work inside the worktree:
+```
+<orchestrator>/.sessions/<ISSUE-ID>/<repo-name>/src/file.ts  ✅
+<orchestrator>/.sessions/<ISSUE-ID>/<repo-name>/tests/test.ts  ✅
+<orchestrator>/.sessions/<ISSUE-ID>/<repo-name>/.eslintrc.js  ✅
+```
+
+**❌ WRONG** - NEVER create code outside the worktree:
+```
+<orchestrator>/.sessions/test.ts  ❌
+<orchestrator>/.sessions/<ISSUE-ID>/test.ts  ❌
+{base_path}/<repo-name>/test.ts  ❌ (main repository!)
+```
+
+**ABSOLUTE RULE**:
+- 🛑 **ALL code** (tests, fixes, configurations) **MUST be in** `<orchestrator>/.sessions/<ISSUE-ID>/<repo-name>/`
+- 🛑 **NEVER modify** the main repository in `{base_path}/<repo-name>/`
+- ✅ **Work ONLY** inside the worktree of the specific repository
+
+## ✅ Validation Checklist
+
+### 1. Implementation Completeness
+
+```markdown
+## Completeness Check
+
+- [ ] All plan tasks have been executed
+- [ ] All functional requirements from the PRD have been implemented
+- [ ] All acceptance criteria have been met
+- [ ] No functionality is half-done
+```
+
+### 2. Code Quality
+
+For each modified repository:
+
+```bash
+cd <repository>
+
+# Check status
+git status
+
+# Check linting (examples by stack):
+# Node.js: npm run lint / yarn lint / pnpm lint
+# Python: flake8 . / pylint src/ / black --check .
+# Java: mvn checkstyle:check / gradle check
+# Go: golangci-lint run / go vet ./...
+# Ruby: rubocop
+# Rust: cargo clippy
+# PHP: ./vendor/bin/phpcs
+# C#: dotnet format --verify-no-changes
+
+# Check formatting (examples by stack):
+# Node.js: npm run format:check / prettier --check .
+# Python: black --check . / autopep8 --diff .
+# Java: mvn formatter:validate
+# Go: gofmt -l . / go fmt ./...
+# Ruby: rubocop --format-only
+# Rust: cargo fmt --check
+
+# Check build (examples by stack):
+# Node.js: npm run build / yarn build
+# Python: python setup.py build
+# Java: mvn compile / gradle build
+# Go: go build ./...
+# Ruby: rake build
+# Rust: cargo build
+```
+
+Checklist:
+```markdown
+## Code Quality
+
+### <repo-1>
+- [ ] Linting without errors
+- [ ] Correct formatting
+- [ ] Build without errors
+- [ ] No critical warnings
+
+### <repo-2>
+- [ ] Linting without errors
+- [ ] Correct formatting
+- [ ] Build without errors
+- [ ] No critical warnings
+```
+
+### 3. Tests
+
+For each repository:
+
+```bash
+cd <repository>
+
+# Run unit tests (examples by stack):
+# Node.js: npm run test:unit / jest / vitest
+# Python: pytest tests/unit / python -m unittest
+# Java: mvn test / gradle test
+# Go: go test ./... -short
+# Ruby: rspec spec/unit / rake test:unit
+# Rust: cargo test --lib
+# PHP: ./vendor/bin/phpunit --testsuite=unit
+# C#: dotnet test --filter Category=Unit
+
+# Run integration tests (examples by stack):
+# Node.js: npm run test:integration
+# Python: pytest tests/integration
+# Java: mvn verify / gradle integrationTest
+# Go: go test ./... -run Integration
+# Ruby: rspec spec/integration
+# Rust: cargo test --test '*'
+# PHP: ./vendor/bin/phpunit --testsuite=integration
+
+# Check coverage (examples by stack):
+# Node.js: npm run test:coverage / jest --coverage
+# Python: pytest --cov=src tests/
+# Java: mvn jacoco:report / gradle jacocoTestReport
+# Go: go test -cover ./...
+# Ruby: rspec --coverage
+# Rust: cargo tarpaulin
+# PHP: ./vendor/bin/phpunit --coverage-html coverage/
+```
+
+Checklist:
+```markdown
+## Tests
+
+### <repo-1>
+- [ ] All unit tests passing
+- [ ] All integration tests passing
+- [ ] Adequate test coverage (>= X%)
+- [ ] New tests added for new features
+
+### <repo-2>
+- [ ] All unit tests passing
+- [ ] All integration tests passing
+- [ ] Adequate test coverage (>= X%)
+- [ ] New tests added for new features
+```
+
+### 4. Documentation
+
+```markdown
+## Documentation
+
+- [ ] README updated (if necessary)
+- [ ] Appropriate code comments
+- [ ] API documentation updated (if there are changes)
+- [ ] Changelog updated
+- [ ] Technical documentation updated in metaspecs (if applicable)
+```
+
+### 5. Commits
+
+```markdown
+## Commits
+
+- [ ] All commits have clear and descriptive messages
+- [ ] Commits follow the project standard (conventional commits, etc.)
+- [ ] No commits with generic messages ("fix", "update", etc.)
+- [ ] Commits are logically organized
+- [ ] No debug or temporary commits
+```
+
+### 6. Synchronization
+
+```markdown
+## Synchronization
+
+- [ ] Branches are up to date with the base branch (main/develop)
+- [ ] No merge conflicts
+- [ ] Changes between repositories are synchronized
+- [ ] Dependencies between repos have been tested
+```
+
+### 7. Security
+
+```markdown
+## Security
+
+- [ ] No credentials or secrets in the code
+- [ ] No sensitive data in logs
+- [ ] Security dependencies have been checked
+- [ ] No known vulnerabilities introduced
+```
+
+### 8. Performance
+
+```markdown
+## Performance
+
+- [ ] No obvious performance regressions
+- [ ] Costly queries/operations have been optimized
+- [ ] No memory leaks introduced
+- [ ] PRD performance requirements have been met
+```
+
+## 🔍 Cross Validation
+
+If multiple repositories were modified:
+
+```markdown
+## Cross Validation
+
+- [ ] Tested integration between repositories locally
+- [ ] APIs/contracts between repos are consistent
+- [ ] No undocumented breaking changes
+- [ ] Deployment/merge order is clear
+```
+
+## 📄 PR Description Preparation
+
+Create `./.sessions/<ISSUE-ID>/pr-description.md`:
+
+```markdown
+## 🎯 Objective
+[Brief description of what this feature does]
+
+## 📝 Main Changes
+- [Change 1]
+- [Change 2]
+- [Change 3]
+
+## 🔗 Links
+- **Issue**: [ISSUE-ID]
+- **PRD**: [link or path]
+- **Technical Plan**: [link or path]
+
+## ✅ Checklist
+- [x] Code implemented and tested
+- [x] Unit tests added/updated
+- [x] Integration tests passing
+- [x] Documentation updated
+- [x] Linting and formatting OK
+- [x] Build without errors
+
+## 🧪 How to Test
+1. [Step 1]
+2. [Step 2]
+3. [Expected result]
+
+## 🔍 Notes for Reviewers
+- [Point of attention 1]
+- [Point of attention 2]
+```
+
+## 🚨 Issues Found
+
+If any validation fails:
+1. 🛑 **STOP** the PR creation process
+2. 📝 **DOCUMENT** the problem
+3. 🔧 **FIX** the problem
+4. 🔄 **RUN** `/pre-pr` again
+
+## 📊 Validation Report
+
+Create `./.sessions/<ISSUE-ID>/pre-pr-report.md`:
+
+```markdown
+# Pre-PR Validation Report
+
+**Date**: [date/time]
+**Issue**: [ISSUE-ID]
+
+## Overall Status
+✅ Ready for PR / ⚠️ Pending / ❌ Blocked
+
+## Validated Repositories
+- **<repo-1>**: ✅ OK
+- **<repo-2>**: ✅ OK
+
+## Test Summary
+- **Unit Tests**: X/X passing
+- **Integration Tests**: Y/Y passing
+- **Coverage**: Z%
+
+## Pending Items (if any)
+- [Pending item 1]
+- [Pending item 2]
+
+## Next Steps
+- [x] All validations passed
+- [ ] Run `/pr` to create Pull Requests
+```
+
+---
+
+**Provided arguments**:
+
+```
+#$ARGUMENTS
+```
+
+---
+
+## 🎯 Next Step
+
+If all validations passed:
+
+```bash
+/pr
+```
+
+This command will create Pull Requests for all modified repositories.