context-compress

name	context-compress
description	Generate and maintain compressed context summaries of the project. Used by agents to load minimal context instead of reading full files. Saves tokens and reduces latency.
allowed-tools	Read, Write, Glob, Grep, Bash

Context Compression — Project Summary Generator

Generate compact summaries of the project's key files so agents can load minimal context instead of reading entire files.

When to Run

• After onboarding a new project
• After significant code changes (new models, new routers, schema changes)
• When tasuki learn runs
• Manually: /context-compress

What It Generates

Creates .tasuki/config/context-summary.md with compressed representations of:

1. Schema Summary

Read all model files, extract: table names, columns, relationships, indexes. Output a compact table, not full source code.

## Schema
| Table | Key Columns | Relationships | Indexes |
|-------|-------------|---------------|---------|
| users | id, email, name, role, tenant_id, deleted_at | has_many: orders, posts | email(unique), tenant_id |
| orders | id, user_id, status, total, created_at | belongs_to: user | user_id, status, created_at |

2. API Summary

Read all router/controller files, extract: method, path, auth, description.

## API Endpoints
| Method | Path | Auth | Description |
|--------|------|------|-------------|
| GET | /health | none | Health check |
| POST | /auth/login | none | Login, returns JWT |
| GET | /api/users | jwt | List users (paginated) |
| POST | /api/orders | jwt+role:admin | Create order |

3. Component Summary (frontend)

Read pages/components, extract: route, purpose, key props.

## Frontend Routes
| Route | Component | Data Source | States |
|-------|-----------|-------------|--------|
| / | HomePage | server load | loading, error |
| /dashboard | Dashboard | client fetch | loading, error, empty |
| /orders/:id | OrderDetail | server load | loading, error, 404 |

4. Infrastructure Summary

## Infrastructure
- Docker services: api (8000), db (5432), redis (6379)
- CI/CD: GitHub Actions (lint → test → build → deploy)
- Deploy target: docker compose
- Env vars: 12 required (see .env.example)

5. Dependency Summary

## Dependencies
- Backend: fastapi, sqlalchemy, alembic, pyjwt, httpx (7 total)
- Frontend: svelte, sveltekit, tailwindcss (12 total)
- Dev: pytest, ruff, vitest (5 total)

Output File

Write to .tasuki/config/context-summary.md:

# Project Context — {{PROJECT_NAME}}
Last updated: {date}

{all sections above}

How Agents Use This

Instead of reading 15 files to understand the project, agents read ONE file:

.tasuki/config/context-summary.md    # ~50 lines vs ~500 lines of source

This is especially useful for:

• Planner: needs project overview, not implementation details
• Security: needs API surface area, not business logic
• Reviewer: needs schema + API summary to cross-reference
• New agents: installed plugins get instant project understanding