# Goga Brainstorm Contracts Usages File

> Designing cell-level consumer usage files for a single cell in the brainstorm contracts pipeline

- **Type:** Skill
- **Install:** `agentstack add skill-qarium-goga-goga-brainstorm-contracts-usages-file`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [qarium](https://agentstack.voostack.com/s/qarium)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** BSD-3-Clause
- **Upstream author:** [qarium](https://github.com/qarium)
- **Source:** https://github.com/qarium/goga/tree/1.1.x/goga/assets/skills/goga-brainstorm-contracts-usages-file

## Install

```sh
agentstack add skill-qarium-goga-goga-brainstorm-contracts-usages-file
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# goga-brainstorm-contracts-usages-file

## Algorithm

Design the consumer API documentation in `/.usages/` for the given cell.

- The **rules for writing** `/.usages/` files follow **`goga-cookbook`**.
- `.usages/` placement and `{name}.md` path resolution follow **`goga-cell`**.

### Step 1 — Collect the cell's API

Build the factual basis for the documentation:

- From **`[TYPE_DETAIL_REPORT]`** — the cell's contract: each type's responsibility, methods/properties/signatures, and
  interactions. This is the API surface a consumer calls.
- From the **usages-inline** and **annotations** results — the connected Usages keys and the documented behavior, so the
  examples reflect how the cell is meant to be consumed.

### Step 2 — Review existing usage files

Review existing md files in `/.usages/` — preserve or extend them; do not overwrite blindly.

### Step 3 — Split into functional domains

Split the API (Step 1) into functional domains by the actions a consumer performs.

### Step 4 — One file per domain

One file per domain: `/.usages/.md`.

### Step 5 — Write the content

Per file: a domain statement (area + target audience), ready-to-use patterns with code examples, and
preconditions/side effects relevant to the consumer. Self-contained — describes **how to use**, not **what to implement**.

### Return

Return the paths: `/.usages/.md` and Full usage-files content.

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [qarium](https://github.com/qarium)
- **Source:** [qarium/goga](https://github.com/qarium/goga)
- **License:** BSD-3-Clause

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-qarium-goga-goga-brainstorm-contracts-usages-file
- Seller: https://agentstack.voostack.com/s/qarium
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.