From 7dff0a16eec070fd18bc0dc0bf587cee60e1524d Mon Sep 17 00:00:00 2001 From: TheFlow Date: Wed, 29 Oct 2025 11:01:50 +1300 Subject: [PATCH] docs(framework): update ffs command documentation with --tokens parameter MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - Document --tokens=/ parameter for real-time pressure - Add warning about cached data being potentially stale - Mark --tokens usage as recommended best practice Note: CLAUDE.md is internal developer documentation, port exposure is acceptable 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude --- CLAUDE.md | 8 +++++++- 1 file changed, 7 insertions(+), 1 deletion(-) diff --git a/CLAUDE.md b/CLAUDE.md index e1d12d2d..a47818a3 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -68,6 +68,10 @@ node scripts/framework-audit-response.js \ When user types **ffs**, display full framework statistics: ```bash +# With real-time context pressure (recommended) +node scripts/framework-stats.js --tokens=/ + +# With cached data (may be stale) node scripts/framework-stats.js ``` @@ -76,13 +80,15 @@ node scripts/framework-stats.js **Reports**: - Session state (ID, message count, status) - Token usage & checkpoints (25%, 50%, 75%) -- Context pressure level & metrics +- Context pressure level & metrics (real-time when --tokens provided) - Instruction counts (by quadrant/persistence) - Audit log counts (by service) - Framework service status (all 6 services) **Output**: Formatted report + JSON for programmatic access +**Important**: Use `--tokens=` parameter for accurate real-time pressure. Without it, displays cached session data which may show 0% pressure. + **When**: User wants to see framework health/activity at any point in session **See**: inst_082 in instruction-history.json