feat: implement new claude skills and workflow

.claude/skills/doc-sync/references/trigger-patterns.md

@@ -0,0 +1,125 @@
+# Trigger Patterns Reference
+
+Examples of well-formed triggers for CLAUDE.md index table entries.
+
+## Column Formula
+
+| File         | What                             | When to read                          |
+| ------------ | -------------------------------- | ------------------------------------- |
+| `[filename]` | [noun-based content description] | [action verb] [specific context/task] |
+
+## Action Verbs by Category
+
+### Implementation Tasks
+
+implementing, adding, creating, building, writing, extending
+
+### Modification Tasks
+
+modifying, updating, changing, refactoring, migrating
+
+### Debugging Tasks
+
+debugging, troubleshooting, investigating, diagnosing, fixing
+
+### Understanding Tasks
+
+understanding, learning, reviewing, analyzing, exploring
+
+## Examples by File Type
+
+### Source Code Files
+
+| File           | What                                | When to read                                                                       |
+| -------------- | ----------------------------------- | ---------------------------------------------------------------------------------- |
+| `cache.rs`     | LRU cache with O(1) operations      | Implementing caching, debugging cache misses, modifying eviction policy            |
+| `auth.rs`      | JWT validation, session management  | Implementing login/logout, modifying token validation, debugging auth failures     |
+| `parser.py`    | Input parsing, format detection     | Modifying input parsing, adding new input formats, debugging parse errors          |
+| `validator.py` | Validation rules, constraint checks | Adding validation rules, modifying validation logic, understanding validation flow |
+
+### Configuration Files
+
+| File           | What                             | When to read                                                                  |
+| -------------- | -------------------------------- | ----------------------------------------------------------------------------- |
+| `config.toml`  | Runtime config options, defaults | Adding new config options, modifying defaults, debugging configuration issues |
+| `.env.example` | Environment variable template    | Setting up development environment, adding new environment variables          |
+| `Cargo.toml`   | Rust dependencies, build config  | Adding dependencies, modifying build configuration, debugging build issues    |
+
+### Test Files
+
+| File                 | What                        | When to read                                                                     |
+| -------------------- | --------------------------- | -------------------------------------------------------------------------------- |
+| `test_cache.py`      | Cache unit tests            | Adding cache tests, debugging test failures, understanding cache behavior        |
+| `integration_tests/` | Cross-component test suites | Adding integration tests, debugging cross-component issues, validating workflows |
+
+### Documentation Files
+
+| File              | What                                     | When to read                                                                             |
+| ----------------- | ---------------------------------------- | ---------------------------------------------------------------------------------------- |
+| `README.md`       | Architecture, design decisions           | Understanding architecture, design decisions, component relationships                    |
+| `ARCHITECTURE.md` | System design, component boundaries      | Understanding system design, component boundaries, data flow                             |
+| `API.md`          | Endpoint specs, request/response formats | Implementing API endpoints, understanding request/response formats, debugging API issues |
+
+### Index Files (cross-cutting concerns)
+
+| File                      | What                               | When to read                                                                    |
+| ------------------------- | ---------------------------------- | ------------------------------------------------------------------------------- |
+| `error-handling-index.md` | Error handling patterns reference  | Understanding error handling patterns, failure modes, error recovery strategies |
+| `performance-index.md`    | Performance optimization reference | Optimizing latency, throughput, resource usage, understanding cost models       |
+| `security-index.md`       | Security patterns reference        | Implementing authentication, encryption, threat mitigation, compliance features |
+
+## Examples by Directory Type
+
+### Feature Directories
+
+| Directory  | What                                    | When to read                                                                          |
+| ---------- | --------------------------------------- | ------------------------------------------------------------------------------------- |
+| `auth/`    | Authentication, authorization, sessions | Implementing authentication, authorization, session management, debugging auth issues |
+| `api/`     | HTTP endpoints, request handling        | Implementing endpoints, modifying request handling, debugging API responses           |
+| `storage/` | Persistence, data access layer          | Implementing persistence, modifying data access, debugging storage issues             |
+
+### Layer Directories
+
+| Directory   | What                          | When to read                                                                     |
+| ----------- | ----------------------------- | -------------------------------------------------------------------------------- |
+| `handlers/` | Request handlers, routing     | Implementing request handlers, modifying routing, debugging request processing   |
+| `models/`   | Data models, schemas          | Adding data models, modifying schemas, understanding data structures             |
+| `services/` | Business logic, service layer | Implementing business logic, modifying service interactions, debugging workflows |
+
+### Utility Directories
+
+| Directory  | What                              | When to read                                                                       |
+| ---------- | --------------------------------- | ---------------------------------------------------------------------------------- |
+| `utils/`   | Helper functions, common patterns | Needing helper functions, implementing common patterns, debugging utility behavior |
+| `scripts/` | Maintenance tasks, automation     | Running maintenance tasks, automating workflows, debugging script execution        |
+| `tools/`   | Development tools, CLI utilities  | Using development tools, implementing tooling, debugging tool behavior             |
+
+## Anti-Patterns
+
+### Too Vague (matches everything)
+
+| File       | What          | When to read               |
+| ---------- | ------------- | -------------------------- |
+| `config/`  | Configuration | Working with configuration |
+| `utils.py` | Utilities     | When you need utilities    |
+
+### Content Description Only (no trigger)
+
+| File       | What                                          | When to read |
+| ---------- | --------------------------------------------- | ------------ |
+| `cache.rs` | Contains the LRU cache implementation         | -            |
+| `auth.rs`  | Authentication logic including JWT validation | -            |
+
+### Missing Action Verb
+
+| File           | What             | When to read                      |
+| -------------- | ---------------- | --------------------------------- |
+| `parser.py`    | Input parsing    | Input parsing and format handling |
+| `validator.py` | Validation rules | Validation rules and constraints  |
+
+## Trigger Guidelines
+
+- Combine 2-4 triggers per entry using commas or "or"
+- Use action verbs: implementing, debugging, modifying, adding, understanding
+- Be specific: "debugging cache misses" not "debugging"
+- If more than 4 triggers needed, the file may be doing too much