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:
2026-01-20 16:20:35 -07:00
parent dc7174a53d
commit 565b6458ba
58 changed files with 1025 additions and 1019 deletions

View File

@@ -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