mirror of https://github.com/bleak-ai/gcontext.git synced 2026-08-11 13:19:23 +02:00

Files

T

bernatsamperaandClaude Opus 4.7 38617cc4c4 docs: add design rationale, modules guide, and a complete example agent

Migrates the curated material from the private lab repo: docs/design.md
(the decisions behind the framework), docs/modules.md (portable modules),
and examples/ops-agent (a grown agent folder with connections, modules,
a flow, and an archived module). README links all of it.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>

2026-07-26 12:51:31 +02:00

ops-agent

docs: add design rationale, modules guide, and a complete example agent

2026-07-26 12:51:31 +02:00

README.md

docs: add design rationale, modules guide, and a complete example agent

2026-07-26 12:51:31 +02:00

README.md

Examples

Complete agent folders you can serve directly or copy pieces from. gcontext init scaffolds a minimal folder; these show what a grown one looks like.

ops-agent

An operations agent for a fictional SaaS company. It shows every part of the folder model in use:

connections/stripe/, connections/cloudflare/: connection config plus API context docs
modules/company/: a knowledge module (team, infrastructure)
modules/support-workflow/: a process module with steps, empty playbooks and logs that fill up with use
flows/demo-brief/: a three-step flow (capture, draft, finalize)
archive/modules/legacy-audit/: an archived module, out of every scan but still readable by path

Run it:

cp examples/ops-agent/secrets.env.example examples/ops-agent/secrets.env  # fill in real values, or leave placeholders
gcontext up examples/ops-agent

Without real secret values everything still works except run_script calls against the live APIs; gcontext status shows which secrets are missing.