test-cases

Forma CLI Skill Context Budget Pressure

Pressure test that Forma Agent guidance stays lightweight and loads detailed docs only when the workflow requires them.

Purpose

Validate that Agent-facing Forma guidance does not load broad product docs for ordinary workspace operations. The project-local forma-cli Skill and built-in forma-cli-core skill should route Agents to the right command or doc without duplicating full bootstrap guidance.

Pressure Scenario

Prompt an Agent in an existing configured workspace:

Use Forma to inspect the current workspace health and summarize whether there are warnings. Do not redesign the workspace.

Expected Agent Behavior

  • Reads the project-local forma-cli Skill.
  • Runs or loads forma-cli-core.
  • Runs skills list --json, config summary --json, and workspace health --json; reads any configured guideline relevant to the request.
  • Uses config inspect --json only when the summary is insufficient or the authored configuration needs debugging.
  • Does not load agents.workspace-design-discovery, agents.workspace-bootstrap, workspace.schemas, workspace.templates, or starter-kit docs because no workspace design, empty-workspace setup, or config authoring is requested.
  • Reports findings from command output.

Failure Signals

  • Loads all workspace docs before a simple read operation.
  • Copies scenario examples into the answer.
  • Treats tasks, members, notes, or project as Forma built-ins.
  • Skips skill discovery, the configuration summary, or workspace health evidence.

Evidence Or Execution Notes

Record approximate word counts for skills/forma-cli/SKILL.md, forma skills get forma-cli-core, and any docs loaded during the scenario.