brainstorm-promotion: author agents/skills/envio-graphql.md

[reubenr0d]

brainstorm-promotion: blocker for the broadcast-bot and basket-ideator brainstorm agents in COMPANY.md. Pairs with the envio-graphql-mcp build (#21).

Background

Two brainstorm agents need to reason about IndexFlow's live on-chain event stream via Envio HyperIndex. The MCP (#21) gives them the wire; this skill gives them the schema vocabulary, the live endpoint URL, the subscription pattern, and the canonical event shapes so they can write correct queries without re-deriving the schema from each tool call.

Spec (lifted from COMPANY.md L177-183)

- name: envio-graphql
  proposedPath: agents/skills/envio-graphql.md
  description: >
    Envio HyperIndex GraphQL schema for IndexFlow (BasketCreated,
    BasketDeposit, etc.), live endpoint URL, subscription pattern.
    Needed by broadcast-bot, basket-ideator, and any future
    growth-analytics agent.

Acceptance criteria

• New agents/skills/envio-graphql.md matching the file conventions of the 4 existing skill files under agents/skills/.
• Documents the live Envio HyperIndex GraphQL endpoint URL (testnet hub) — pull from apps/envio/ config and apps/web/src/config/*-deployment.json.
• Documents the canonical event types with field shapes by reading the actual Envio schema config under apps/envio/ (don't invent fields):
  • BasketCreated (basketAddress, name, curator, assetCount, timestamp, txHash, blockNumber, etc.)
  • BasketDeposit (basketAddress, depositor, amount, timestamp, txHash)
  • Any other event types Envio currently indexes
• Documents the subscription pattern (or the polling fallback if HyperIndex doesn't expose subscriptions) — cross-references the */15 * * * * cadence in broadcast-bot.heartbeat.
• Documents at least 2 worked example queries:
  • "Last N BasketCreated events since timestamp X" (broadcast-bot use case)
  • "Distinct basket themes already on-chain" (basket-ideator de-dupe use case)
• Cross-references the envio-graphql-mcp build (brainstorm-promotion: build apps/mcps/envio-graphql/ (envio-graphql-mcp) #21) — the MCP is the wire; this skill is the schema.
• CHANGELOG.md entry timestamped per repo convention.

Lifecycle next steps after PR merges

1. Reference the skill from the broadcast-bot and basket-ideator agent prompt files (separate issues).
2. Once either consumer flips state: brainstorm → state: active, also flip skills.proposed → skills.active for envio-graphql.

References

• COMPANY.md §Skills L177-183 (canonical spec)
• Consumers:
  • COMPANY.md §Brainstorm broadcast-bot.proposedSkills (L423)
  • COMPANY.md §Brainstorm basket-ideator.proposedSkills (L483)
• Wire: brainstorm-promotion: build apps/mcps/envio-graphql/ (envio-graphql-mcp) #21 (envio-graphql-mcp build)
• Source material: apps/envio/, apps/web/src/config/*-deployment.json
• Existing skill conventions: agents/skills/vault-manager.md, agents/skills/atlas-quality.md

[reubenr0d]

Implemented: agents/skills/envio-graphql.md — read-only HyperIndex query patterns, endpoint resolution, and chainId filtering.