Florian BRUNIAUX
ac50ee7ad8
docs: add monitoring & activity audit sections to observability guide
...
- guide/observability.md: +3 sections (Activity Monitoring, External Tools, Proxying)
- Activity Monitoring: JSONL tool_use audit, jq queries, sensitive pattern detection
- External Tools: ccusage / claude-code-otel / Akto / MLflow / ccboard comparison
- Proxying: NODE_EXTRA_CA_CERTS, ANTHROPIC_API_URL, mitmproxy, Python proxy
- docs: ccboard Activity module implementation plan (Tab 10, Rust models, SQLite cache)
- docs: Mergify cross-system support evaluation
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-02-21 20:29:05 +01:00
Florian BRUNIAUX
ac9b07a837
docs(guide): add YAML frontmatter to 24 top-level guide files
...
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-15 19:20:31 +01:00
Florian BRUNIAUX
d72905e9ba
docs: integrate Entire CLI across guide (v3.27.0)
...
Major integration of Entire CLI, an agent-native platform launched
Feb 2026 by Thomas Dohmke (ex-GitHub CEO) with $60M funding. Provides
rewindable checkpoints, approval gates, and audit trails for AI sessions.
## Added (7 guide files + 3 meta files)
- **ai-traceability.md**: Replace git-ai 404 with Entire CLI (section 5.1)
- **third-party-tools.md**: Fill "Session replay" gap + add tool section
- **observability.md**: Add session portability alternative
- **ai-ecosystem.md**: Add governance-first orchestration (section 8.1.5)
- **ultimate-guide.md**: Enrich multi-instance section 9.17
- **security-hardening.md**: Add compliance audit trails (section 3.4)
- **cheatsheet.md**: Add Community Tools quick reference
- **README.md**: Update structure tree with third-party-tools mention
- **CHANGELOG.md**: Document v3.27.0 release
- **docs/resource-evaluations/entire-cli.md**: Formal evaluation (5/5)
## Fixed
- git-ai references (404 repo) replaced with working alternative
- "Session replay" Known Gap now marked as ✅ FILLED
## Key Features Documented
- Rewindable checkpoints (prompts + reasoning + tool usage)
- Governance layer (approval gates, permissions, audit trails)
- Multi-agent handoffs (Claude → Gemini with context)
- Compliance-ready (SOC2, HIPAA, FedRAMP)
- Session portability (path-agnostic vs native --resume)
## Positioning
- vs git-ai: Replaces non-existent tool (404)
- vs claude-code-viewer: Active replay vs read-only history
- vs Gas Town: Governance sequential vs parallel coordination
Files modified: 10 (7 content + 3 meta)
Words added: ~2,500
Version: 3.26.0 → 3.27.0
Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-02-12 23:33:16 +01:00
Florian BRUNIAUX
17846b1179
docs: complete Wasp fullstack essentials integration
...
Complete all 4 action items from wasp-fullstack-essentials-eval.md resource
evaluation (score 3/5). Framework-agnostic insights only, promotional content
excluded.
Changes (3 sections):
1. Background tasks workflow (Section 9.5)
- New subsection: "Background Tasks for Fullstack Development"
- When to background tasks (5 scenarios table)
- Fullstack workflow pattern with examples
- Context rot prevention strategies
- Limitations and workarounds
- Integration with teleportation
- /tasks monitoring guide
- ~100 lines added to Section 9.5 "Tight Feedback Loops"
2. Chrome DevTools MCP (mcp-servers-ecosystem.md)
- New server entry in "Browser Automation" section
- Official Anthropic server (not community)
- Comparison table vs Playwright MCP (debugging vs testing)
- Setup and configuration
- Use cases and limitations
- Updated stats: 3 browser servers (was 2), 6 official servers (was 5)
- ~60 lines added to Browser Automation section
3. Convention-over-config for AI (Section 9.18.1)
- New subsection: "Convention-Over-Configuration for AI Agents"
- Why opinionated frameworks reduce agent cognitive load
- Comparison table: custom vs opinionated architectures
- Examples: Next.js, Rails, Phoenix, Django
- Real-world impact on agent productivity
- Trade-offs analysis
- Connection to CLAUDE.md sizing (token reduction)
- ~60 lines added to Section 9.18.1
Total additions: ~220 lines (workflow patterns + MCP server + AX framework)
Source evaluation: docs/resource-evaluations/wasp-fullstack-essentials-eval.md
Primary sources: llmstxt.org (llms.txt), official docs (background tasks, Chrome
DevTools MCP), existing Section 9.18 (Marmelab/AX framework)
Related commits:
- 783c43b : llms.txt conceptual documentation (completed earlier)
Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-02-09 10:00:53 +01:00
Florian BRUNIAUX
f1c6c47dc4
docs: add third-party-tools.md links to guide index and observability
...
Add cross-references to newly created third-party-tools.md:
- guide/README.md: Add third-party-tools.md to contents table
- guide/observability.md: Add link to third-party-tools section
Related to RTK documentation integration (commit fdee330 ).
Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-02-01 22:59:36 +01:00
Florian BRUNIAUX
29f778daf7
docs: update template count badge (82 → 83)
...
Co-Authored-By: Claude <noreply@anthropic.com>
2026-01-25 13:30:40 +01:00
Florian BRUNIAUX
785727d16c
feat(scripts): session-search v2.0 with advanced filtering
...
- Multi-word AND search (all words must match)
- Project filter (-p, --project)
- Date filter (--since today/7d/30d/YYYY-MM-DD)
- JSON output (--json) for scripting
- Improved preview extraction (skips tool results)
- 3s search timeout for safety
- Updated documentation in observability.md
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-15 09:52:54 +01:00
Florian BRUNIAUX
46c5862c4e
fix(docs): critical factual corrections v3.6.1
...
Major audit correcting misleading documentation about Claude Code behavior:
### Fixed
- `--add-dir`: permissions (not context loading)
- `excludePatterns` → `permissions.deny` (never existed)
- `.claudeignore` removed (not an official feature)
- "selective loading" myth → lazy loading reality
- Invented CLI flags (`--think`, `--headless`, `--learn`) → prompt keywords
- `@` file reference: "loads automatically" → "reads on-demand"
### Added
- Session Search Tool (`cs`) - zero-dep bash script for finding sessions
- Security section: Known limitations of permissions.deny
15 files modified, 516 insertions, 200 deletions
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-15 09:16:53 +01:00
Florian BRUNIAUX
8a4d116e2e
feat(docs): add LLM Handbook + Google Whitepaper integration v3.3.0
...
Advanced Guardrails:
- prompt-injection-detector.sh (PreToolUse)
- output-validator.sh (PostToolUse heuristics)
- claudemd-scanner.sh (SessionStart injection detection)
- output-secrets-scanner.sh (PostToolUse secrets leak prevention)
Observability & Monitoring:
- session-logger.sh (JSONL activity logging)
- session-stats.sh (cost tracking & analysis)
- guide/observability.md (full documentation)
LLM-as-a-Judge Evaluation:
- output-evaluator.md agent (Haiku)
- /validate-changes command
- pre-commit-evaluator.sh (opt-in git hook)
Google Agent Whitepaper Integration:
- Context Triage Guide (Section 2.2.4)
- CLAUDE.md Injection Warning (Section 3.1.3)
- Agent Validation Checklist (Section 4.2.4)
- MCP Security: Tool Shadowing & Confused Deputy (Section 8.6)
- Session vs Memory patterns (Section 3.3.3)
Stats: 10 new files, 8 modified, 5 new guide sections
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-14 21:00:49 +01:00