# Goga Brainstorm Contracts Annotations

> Writing annotations at all levels for a single cell in the brainstorm contracts pipeline

- Skill: `qarium/goga-brainstorm-contracts-annotations` (Agent Skill)
- Install (CLI): `npx skillmds@latest add qarium/goga-brainstorm-contracts-annotations`
- Raw SKILL.md: https://api.skillmd.com/api/skills/qarium/goga-brainstorm-contracts-annotations/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: DevOps & Infra
- Author: qarium (https://skillmd.com/u/qarium)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/qarium/goga-brainstorm-contracts-annotations

---


# goga-brainstorm-contracts-annotations

## Algorithm

Write the implementation instructions for the given cell. Process every annotation target in order — cell header,
then each `Entity`/`Routine`, then each method/property — and for each one:

1. **Determine the level**: **global** (cell header), **type-level** (per `Entity`/`Routine`), or **member-level** (per
   method/property). The level selects the content — see `goga-cookbook` "When to write annotations". The **global**
   level additionally includes the **base annotations** from `goga-codemanifest-base` (the contract must comply with
   their constraints).

2. **Decide what content the annotation needs.** Do not invent content — derive it:
   - From **`[TYPE_DETAIL_REPORT]`** — responsibility, signature (params and return), methods/properties, interactions.
   - From the **usages-inline result** — the connected **Usages keys**; place each on the level where the practice applies.
   - From **`goga-cookbook`** ("Why") — the content categories that fit the level.

3. **Write the annotation** by `goga-cookbook` Annotations writing standard (elements, the `Algorithm:` placement
   rule), references, and the **sufficiency criterion**: if not sufficient for implementation, add the missing element
   (`Algorithm:` / `Requirements:` / `Constraints:`).

4. **Verify** against `goga-cookbook` Annotations — references resolve, no cross-level duplication, no implementation
   details.