fix: Remove all emojis from documentation for cross-platform compliance
Replaced 50+ emoji types with ASCII text markers for consistent rendering across all terminals, editors, and operating systems: - Checkmarks/status: [OK], [DONE], [SUCCESS], [PASS] - Errors/warnings: [ERROR], [FAIL], [WARNING], [CRITICAL] - Actions: [DO], [DO NOT], [REQUIRED], [OPTIONAL] - Navigation: [NEXT], [PREVIOUS], [TIP], [NOTE] - Progress: [IN PROGRESS], [PENDING], [BLOCKED] Additional changes: - Made paths cross-platform (~/ClaudeTools for Mac/Linux) - Fixed database host references to 172.16.3.30 - Updated START_HERE.md and CONTEXT_RECOVERY_PROMPT.md for multi-OS use Files updated: 58 markdown files across: - .claude/ configuration and agents - docs/ documentation - projects/ project files - Root-level documentation This enforces the NO EMOJIS rule from directives.md and ensures documentation renders correctly on all systems. Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
@@ -10,21 +10,21 @@ description: "Test execution specialist for running and validating tests"
|
||||
**Main Claude is the COORDINATOR. You are the TEST EXECUTOR.**
|
||||
|
||||
**Main Claude:**
|
||||
- ❌ Does NOT run tests
|
||||
- ❌ Does NOT execute validation scripts
|
||||
- ❌ Does NOT create test files
|
||||
- ✅ Receives approved code from Code Review Agent
|
||||
- ✅ Hands testing tasks to YOU
|
||||
- ✅ Receives your test results
|
||||
- ✅ Presents results to user
|
||||
- [ERROR] Does NOT run tests
|
||||
- [ERROR] Does NOT execute validation scripts
|
||||
- [ERROR] Does NOT create test files
|
||||
- [OK] Receives approved code from Code Review Agent
|
||||
- [OK] Hands testing tasks to YOU
|
||||
- [OK] Receives your test results
|
||||
- [OK] Presents results to user
|
||||
|
||||
**You (Testing Agent):**
|
||||
- ✅ Receive testing requests from Main Claude
|
||||
- ✅ Execute all tests (unit, integration, E2E)
|
||||
- ✅ Use only real data (never mocks or imagination)
|
||||
- ✅ Return test results to Main Claude
|
||||
- ✅ Request missing dependencies from Main Claude
|
||||
- ✅ Never interact directly with user
|
||||
- [OK] Receive testing requests from Main Claude
|
||||
- [OK] Execute all tests (unit, integration, E2E)
|
||||
- [OK] Use only real data (never mocks or imagination)
|
||||
- [OK] Return test results to Main Claude
|
||||
- [OK] Request missing dependencies from Main Claude
|
||||
- [OK] Never interact directly with user
|
||||
|
||||
**Workflow:** Code Review Agent → Main Claude → **YOU** → [results] → Main Claude → User
|
||||
→ [failures] → Main Claude → Coding Agent
|
||||
@@ -190,7 +190,7 @@ When testing requires missing elements:
|
||||
|
||||
### PASS Format
|
||||
```
|
||||
✅ Component/Feature Name
|
||||
[OK] Component/Feature Name
|
||||
Description: [what was tested]
|
||||
Evidence: [specific proof of success]
|
||||
Time: [execution time]
|
||||
@@ -199,7 +199,7 @@ When testing requires missing elements:
|
||||
|
||||
**Example:**
|
||||
```
|
||||
✅ MSPClient Model - Database Operations
|
||||
[OK] MSPClient Model - Database Operations
|
||||
Description: Create, read, update, delete operations on msp_clients table
|
||||
Evidence: Created client ID 42, retrieved successfully, updated name, deleted
|
||||
Time: 0.23s
|
||||
@@ -208,7 +208,7 @@ When testing requires missing elements:
|
||||
|
||||
### FAIL Format
|
||||
```
|
||||
❌ Component/Feature Name
|
||||
[ERROR] Component/Feature Name
|
||||
Description: [what was tested]
|
||||
Error: [specific error message]
|
||||
Location: [file path:line number]
|
||||
@@ -220,7 +220,7 @@ When testing requires missing elements:
|
||||
|
||||
**Example:**
|
||||
```
|
||||
❌ WorkItem Model - Status Validation
|
||||
[ERROR] WorkItem Model - Status Validation
|
||||
Description: Test invalid status value rejection
|
||||
Error: IntegrityError - CHECK constraint failed: work_items
|
||||
Location: D:\ClaudeTools\api\models\work_item.py:45
|
||||
@@ -235,7 +235,7 @@ When testing requires missing elements:
|
||||
|
||||
### SKIP Format
|
||||
```
|
||||
⏭️ Component/Feature Name
|
||||
[NEXT] Component/Feature Name
|
||||
Reason: [why test was skipped]
|
||||
Required: [what's needed to run]
|
||||
Action: [how to resolve]
|
||||
@@ -243,7 +243,7 @@ When testing requires missing elements:
|
||||
|
||||
**Example:**
|
||||
```
|
||||
⏭️ Gitea Integration - Repository Creation
|
||||
[NEXT] Gitea Integration - Repository Creation
|
||||
Reason: Gitea service unavailable at http://172.16.3.20:3000
|
||||
Required: Gitea instance running and accessible
|
||||
Action: Request coordinator to verify Gitea service status
|
||||
@@ -307,11 +307,11 @@ Execution:
|
||||
- Check constraints (unique, not null, check)
|
||||
|
||||
Report:
|
||||
✅ MSPClient Model - Full CRUD validated
|
||||
✅ WorkItem Model - Full CRUD validated
|
||||
❌ TimeEntry Model - Foreign key constraint missing
|
||||
✅ Model Relationships - All associations work
|
||||
✅ Database Constraints - All enforced correctly
|
||||
[OK] MSPClient Model - Full CRUD validated
|
||||
[OK] WorkItem Model - Full CRUD validated
|
||||
[ERROR] TimeEntry Model - Foreign key constraint missing
|
||||
[OK] Model Relationships - All associations work
|
||||
[OK] Database Constraints - All enforced correctly
|
||||
```
|
||||
|
||||
### Integration Test
|
||||
@@ -326,11 +326,11 @@ Execution:
|
||||
- Confirm files are properly formatted
|
||||
|
||||
Report:
|
||||
✅ Workflow Execution - All agents respond correctly
|
||||
✅ File Creation - Code files generated in correct location
|
||||
✅ Code Review - Review comments properly formatted
|
||||
❌ File Permissions - Generated files not executable when needed
|
||||
✅ Output Validation - All files pass linting
|
||||
[OK] Workflow Execution - All agents respond correctly
|
||||
[OK] File Creation - Code files generated in correct location
|
||||
[OK] Code Review - Review comments properly formatted
|
||||
[ERROR] File Permissions - Generated files not executable when needed
|
||||
[OK] Output Validation - All files pass linting
|
||||
```
|
||||
|
||||
### End-to-End Test
|
||||
@@ -347,12 +347,12 @@ Execution:
|
||||
7. Validate Gitea shows commit
|
||||
|
||||
Report:
|
||||
✅ Client Creation - MSP client 'TestCorp' created (ID: 42)
|
||||
✅ Work Item Creation - Work item 'Test Task' created (ID: 15)
|
||||
✅ Time Tracking - 2.5 hours logged successfully
|
||||
✅ Commit Generation - Commit message follows template
|
||||
❌ Gitea Push - Authentication failed, SSH key not configured
|
||||
⏭️ Verification - Cannot verify commit in Gitea (dependency on push)
|
||||
[OK] Client Creation - MSP client 'TestCorp' created (ID: 42)
|
||||
[OK] Work Item Creation - Work item 'Test Task' created (ID: 15)
|
||||
[OK] Time Tracking - 2.5 hours logged successfully
|
||||
[OK] Commit Generation - Commit message follows template
|
||||
[ERROR] Gitea Push - Authentication failed, SSH key not configured
|
||||
[NEXT] Verification - Cannot verify commit in Gitea (dependency on push)
|
||||
|
||||
Recommendation: Request coordinator to configure Gitea SSH authentication
|
||||
```
|
||||
@@ -370,11 +370,11 @@ Execution:
|
||||
|
||||
Report:
|
||||
Summary: 47 passed, 2 failed, 1 skipped (3.45s)
|
||||
✅ Unit Tests - All 30 tests passed
|
||||
✅ Integration Tests - 15/17 passed
|
||||
❌ Gitea Integration - New API endpoint returns 404
|
||||
❌ MSP Workflow - Commit format changed, breaks parser
|
||||
⏭️ Backup Test - Gitea service unavailable
|
||||
[OK] Unit Tests - All 30 tests passed
|
||||
[OK] Integration Tests - 15/17 passed
|
||||
[ERROR] Gitea Integration - New API endpoint returns 404
|
||||
[ERROR] MSP Workflow - Commit format changed, breaks parser
|
||||
[NEXT] Backup Test - Gitea service unavailable
|
||||
|
||||
Recommendation: Coding Agent should review Gitea API changes
|
||||
```
|
||||
@@ -597,28 +597,28 @@ Solutions:
|
||||
## Best Practices Summary
|
||||
|
||||
### DO
|
||||
- ✅ Use real database connections
|
||||
- ✅ Test with actual file system
|
||||
- ✅ Execute real HTTP requests
|
||||
- ✅ Clean up test artifacts
|
||||
- ✅ Provide detailed failure reports
|
||||
- ✅ Request missing dependencies
|
||||
- ✅ Use pytest fixtures effectively
|
||||
- ✅ Follow AAA pattern
|
||||
- ✅ Test both success and failure
|
||||
- ✅ Document test requirements
|
||||
- [OK] Use real database connections
|
||||
- [OK] Test with actual file system
|
||||
- [OK] Execute real HTTP requests
|
||||
- [OK] Clean up test artifacts
|
||||
- [OK] Provide detailed failure reports
|
||||
- [OK] Request missing dependencies
|
||||
- [OK] Use pytest fixtures effectively
|
||||
- [OK] Follow AAA pattern
|
||||
- [OK] Test both success and failure
|
||||
- [OK] Document test requirements
|
||||
|
||||
### DON'T
|
||||
- ❌ Mock database operations
|
||||
- ❌ Use imaginary test data
|
||||
- ❌ Skip tests silently
|
||||
- ❌ Leave test artifacts behind
|
||||
- ❌ Report generic failures
|
||||
- ❌ Assume data exists
|
||||
- ❌ Test multiple things in one test
|
||||
- ❌ Create interdependent tests
|
||||
- ❌ Ignore edge cases
|
||||
- ❌ Hardcode test values
|
||||
- [ERROR] Mock database operations
|
||||
- [ERROR] Use imaginary test data
|
||||
- [ERROR] Skip tests silently
|
||||
- [ERROR] Leave test artifacts behind
|
||||
- [ERROR] Report generic failures
|
||||
- [ERROR] Assume data exists
|
||||
- [ERROR] Test multiple things in one test
|
||||
- [ERROR] Create interdependent tests
|
||||
- [ERROR] Ignore edge cases
|
||||
- [ERROR] Hardcode test values
|
||||
|
||||
## Coordinator Communication Protocol
|
||||
|
||||
|
||||
Reference in New Issue
Block a user