docs(marketplace): README rewrite, scripts audit, stale reference cleanup (v9.1.1)
- README.md fully rewritten: clean domain-grouped plugin tables, accurate structure tree matching CANONICAL-PATHS, all 10 scripts and 7 docs listed - CLAUDE.md structure tree updated to match (was showing only 12 plugins) - Deleted scripts/check-venv.sh (dead code for unimplemented SessionStart hooks) - Fixed stale .doc-guardian-queue references in doc-sync.md and sync-workflow.md - Removed check-venv.sh from CANONICAL-PATHS.md, added missing consumer scripts - Version bumped to 9.1.1 Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
@@ -22,11 +22,11 @@ Apply all pending documentation updates detected by `/doc audit`.
|
||||
|
||||
## Process
|
||||
|
||||
1. **Review Pending Queue**
|
||||
Execute `skills/sync-workflow.md` - read `.doc-guardian-queue`
|
||||
1. **Detect Drift**
|
||||
Run `/doc audit` first (or use its most recent results) to identify documentation that is out of sync with code.
|
||||
|
||||
2. **Batch Updates**
|
||||
For each pending item:
|
||||
For each drift item:
|
||||
- Show the specific change needed
|
||||
- Apply the update
|
||||
- Track in change list
|
||||
@@ -36,8 +36,5 @@ Apply all pending documentation updates detected by `/doc audit`.
|
||||
- Single commit: `docs: sync documentation with code changes`
|
||||
- Include summary in commit body
|
||||
|
||||
4. **Clear Queue**
|
||||
After successful sync, clear the queue file
|
||||
|
||||
5. **Output**
|
||||
4. **Output**
|
||||
Use format from `skills/sync-workflow.md`
|
||||
|
||||
@@ -16,20 +16,11 @@ Defines how to synchronize documentation with code changes.
|
||||
|
||||
---
|
||||
|
||||
## Queue File
|
||||
## Drift Detection
|
||||
|
||||
Location: `.doc-guardian-queue` in project root
|
||||
Run `/doc audit` to detect documentation drift. The audit produces a list of files and changes that need synchronization. Use those results as input to the sync process below.
|
||||
|
||||
Format:
|
||||
```
|
||||
# Doc Guardian Queue
|
||||
# Generated: YYYY-MM-DD HH:MM:SS
|
||||
|
||||
## Pending Updates
|
||||
- README.md:45 | reference | calculate_total -> compute_total
|
||||
- CLAUDE.md:23 | version | Python 3.9 -> 3.11
|
||||
- src/api/README.md:12 | path | old/path.py -> new/path.py
|
||||
```
|
||||
> **Note:** The queue file (`.doc-guardian-queue`) was removed in v8.1.0 when the PostToolUse hook was deleted (Decision #29). Drift detection is now manual via `/doc audit`.
|
||||
|
||||
---
|
||||
|
||||
@@ -55,9 +46,9 @@ Format:
|
||||
|
||||
## Sync Process
|
||||
|
||||
1. **Review Queue**
|
||||
- Read `.doc-guardian-queue`
|
||||
- List all pending items
|
||||
1. **Review Drift Results**
|
||||
- Use output from `/doc audit`
|
||||
- List all items needing sync
|
||||
|
||||
2. **Batch Updates**
|
||||
- Apply each update
|
||||
@@ -68,11 +59,6 @@ Format:
|
||||
- Single commit: `docs: sync documentation with code changes`
|
||||
- Include summary in commit body
|
||||
|
||||
4. **Clear Queue**
|
||||
```bash
|
||||
echo "# Doc Guardian Queue - cleared after sync on $(date +%Y-%m-%d)" > .doc-guardian-queue
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Output Format
|
||||
|
||||
Reference in New Issue
Block a user