docs: update metadata and statistics for v3.9.9
Update CHANGELOG, README, and workflow docs to reflect latest additions.
Changes:
1. CHANGELOG.md
- 4 new entries under [Unreleased] → Added:
* llms.txt Standard Documentation (Section 9.18.4)
* Background Tasks Workflow (Section 9.5)
* Chrome DevTools MCP Server (mcp-servers-ecosystem.md)
* Convention-Over-Configuration for AI (Section 9.18.1)
- Each entry with line numbers, resources, gaps addressed
2. README.md statistics
- Guide lines: 16K → 19K (actual: 18,820 lines)
- Templates: 107 → 111 (verified count)
- Evaluations: 55 → 56 (wasp-fullstack-essentials-eval.md)
- Updated in 8 locations: hero, badges, mermaid diagram, structure
3. guide/workflows/agent-teams-quick-start.md
- Improved task delegation clarity (Content Scope, Index Scope labels)
- Enhanced context boundaries in multi-file operations
Statistics verification:
- Templates: find examples -type f | wc -l → 111
- Guide lines: wc -l guide/ultimate-guide.md → 18,820
- Evaluations: docs/resource-evaluations/README.md → 56
Related commits:
- 783c43b: llms.txt conceptual documentation
- 17846b1: Background tasks + Chrome DevTools + convention-over-config
Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
This commit is contained in:
parent
baebe23816
commit
94b9ad4f89
4 changed files with 86 additions and 37 deletions
|
|
@ -206,20 +206,23 @@ Team: doc-update (3 agents)
|
|||
**Copy-paste prompt**:
|
||||
```
|
||||
> Update documentation for new "[FEATURE NAME]" feature:
|
||||
> - Content writer: Write section [X.Y] in guide/ultimate-guide.md with:
|
||||
> - Content Scope: Write section [X.Y] in guide/ultimate-guide.md with:
|
||||
> - Overview (what/why/when)
|
||||
> - 2-3 concrete examples
|
||||
> - Best practices + gotchas
|
||||
> - Links to related sections
|
||||
> - Index updater: Update:
|
||||
> Context: guide/ultimate-guide.md section [X.Y] only
|
||||
> - Index Scope: Update:
|
||||
> - guide/ultimate-guide.md TOC (add section [X.Y])
|
||||
> - machine-readable/reference.yaml (add entry with line numbers)
|
||||
> - README.md navigation (add link if major feature)
|
||||
> - Consistency checker: Verify:
|
||||
> Context: Index files only (TOC, reference.yaml, README.md)
|
||||
> - Consistency Scope: Verify:
|
||||
> - All cross-references resolve correctly
|
||||
> - Line numbers in reference.yaml match actual content
|
||||
> - Anchors in README point to correct sections
|
||||
> - No broken internal links
|
||||
> Context: All modified files for cross-reference validation
|
||||
```
|
||||
|
||||
**ROI**:
|
||||
|
|
@ -259,22 +262,25 @@ Team: security-pr-review (3 agents)
|
|||
|
||||
**Copy-paste prompt**:
|
||||
```
|
||||
> Review PR #[NUMBER] with security focus:
|
||||
> - Rust expert: Check:
|
||||
> Review PR #[NUMBER] with scope-focused analysis:
|
||||
> - Rust Scope: Check:
|
||||
> - Ownership patterns (prefer &str over String, minimize clones)
|
||||
> - Error handling (anyhow::Result with .context(), no unwrap outside tests)
|
||||
> - Idiomatic code (impl after type, #[cfg(test)] mod tests)
|
||||
> - Clippy compliance (zero warnings)
|
||||
> - Security auditor: Scan for:
|
||||
> Context: All modified .rs files
|
||||
> - Security Scope: Scan for:
|
||||
> - Command injection (shell escapes, argument sanitization)
|
||||
> - Token/credential leaks (hardcoded secrets, logs, error messages)
|
||||
> - Input sanitization (path traversal, regex DoS)
|
||||
> - File operations (path validation, permissions)
|
||||
> - Perf analyzer: Review:
|
||||
> Context: Input handling, auth, file I/O code
|
||||
> - Performance Scope: Review:
|
||||
> - Unnecessary allocations (String::from vs &str)
|
||||
> - Async patterns (spawn_blocking for CPU-bound work)
|
||||
> - Compiled regex (lazy_static! for hot paths)
|
||||
> - Algorithm complexity (O(n) vs O(n²))
|
||||
> Context: Hot paths, loops, async functions
|
||||
```
|
||||
|
||||
**ROI**:
|
||||
|
|
@ -326,7 +332,7 @@ Verdict: ✅ Critical security issues caught, PR requires revision
|
|||
**Use Agent Teams when**:
|
||||
- ✅ You'd naturally think "I should check X, Y, and Z"
|
||||
- ✅ High stakes (production release, external contributor, security-sensitive)
|
||||
- ✅ Multi-domain expertise needed (Rust + Security + Performance)
|
||||
- ✅ Multi-scope analysis needed (Rust scope + Security scope + Performance scope)
|
||||
- ✅ Cross-file consistency matters (links, counts, versions sync)
|
||||
- ✅ Parallel work possible (independent tasks, no sequential dependency)
|
||||
|
||||
|
|
@ -351,11 +357,11 @@ claude
|
|||
|
||||
# 3. Create team (prompt template)
|
||||
> Create a team to [TASK]:
|
||||
> - Agent 1 ([ROLE]): [SPECIFIC MISSION]
|
||||
> - Agent 2 ([ROLE]): [SPECIFIC MISSION]
|
||||
> - Agent 3 ([ROLE]): [SPECIFIC MISSION]
|
||||
> - Agent 1 ([SCOPE/CONTEXT]): [SPECIFIC MISSION]
|
||||
> - Agent 2 ([SCOPE/CONTEXT]): [SPECIFIC MISSION]
|
||||
> - Agent 3 ([SCOPE/CONTEXT]): [SPECIFIC MISSION]
|
||||
>
|
||||
> [CONTEXT/FILES TO REVIEW]
|
||||
> [FILES/DIRECTORIES TO ANALYZE]
|
||||
|
||||
# 4. Observe (optional)
|
||||
# Shift+Up/Down to see individual agent outputs
|
||||
|
|
@ -381,19 +387,19 @@ claude
|
|||
#### Security PR Review (RTK)
|
||||
|
||||
```
|
||||
> Review PR #42 with security focus:
|
||||
> - Rust expert: Check ownership patterns, error handling (anyhow/thiserror), idiomatic code in modified files
|
||||
> - Security auditor: Scan for injection risks, token leaks, input sanitization
|
||||
> - Perf analyzer: Review allocations, async patterns, compiled regex
|
||||
> Review PR #42 with scope-focused analysis:
|
||||
> - Rust Scope: Check ownership patterns, error handling (anyhow/thiserror), idiomatic code in modified files (context: src/**/*.rs)
|
||||
> - Security Scope: Scan for injection risks, token leaks, input sanitization (context: auth, input handling code)
|
||||
> - Performance Scope: Review allocations, async patterns, compiled regex (context: hot paths, loops)
|
||||
```
|
||||
|
||||
#### Multi-File Doc Update
|
||||
|
||||
```
|
||||
> Update documentation for new "Agent Teams Quick Start" feature:
|
||||
> - Content writer: Write guide/workflows/agent-teams-quick-start.md with overview, 4 patterns, decision matrix, metrics
|
||||
> - Index updater: Update guide/ultimate-guide.md (add reference section 9.20), machine-readable/reference.yaml (add entry), CHANGELOG.md (add "Added" entry)
|
||||
> - Consistency checker: Verify all cross-refs work, line numbers match, no broken links
|
||||
> - Content Scope: Write guide/workflows/agent-teams-quick-start.md with overview, 4 patterns, decision matrix, metrics
|
||||
> - Index Scope: Update guide/ultimate-guide.md (add reference section 9.20), machine-readable/reference.yaml (add entry), CHANGELOG.md (add "Added" entry)
|
||||
> - Consistency Scope: Verify all cross-refs work, line numbers match, no broken links (context: all modified files)
|
||||
```
|
||||
|
||||
#### Landing Sync Validation
|
||||
|
|
@ -473,8 +479,8 @@ Verdict: ✅ High value for pre-release audits
|
|||
```
|
||||
|
||||
**Adjust prompts** if metrics fail:
|
||||
- Low convergence (<30%) → Agents too specialized, overlap prompts more
|
||||
- No unique insights → Agents too similar, diversify expertise
|
||||
- Low convergence (<30%) → Scopes too narrow, overlap context boundaries more
|
||||
- No unique insights → Scopes too similar, diversify analysis angles
|
||||
- High false positives (>20%) → Prompts too vague, add concrete criteria
|
||||
|
||||
---
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue