Skip to content

docs: add Devin appendix to primitives matrix (#200)#307

Merged
cobusgreyling merged 1 commit into
cobusgreyling:mainfrom
Mahizhan-S:docs/devin-appendix-primitives-matrix
Jul 19, 2026
Merged

docs: add Devin appendix to primitives matrix (#200)#307
cobusgreyling merged 1 commit into
cobusgreyling:mainfrom
Mahizhan-S:docs/devin-appendix-primitives-matrix

Conversation

@Mahizhan-S

Copy link
Copy Markdown
Contributor

Summary

This PR adds a new Devin (Cognition) appendix to docs/primitives-matrix.md, extending the primitives matrix with guidance for using Devin as a loop host.

Changes

  • Added a Devin (Cognition) appendix.
  • Mapped core loop primitives to Devin equivalents, including:
    • Scheduled Sessions (scheduling)
    • Playbooks (skills)
    • Connectors
    • Managed Devins (sub-agents)
    • Knowledge Base and STATE.md (state management)
    • PR-only write workflow
  • Added a Minimal Transfer Recipe for onboarding an existing loop to Devin.
  • Added a Week-one Daily Triage example focused on report-only execution, limiting repository changes to STATE.md.
  • Added Human Gate guidance for L2+ workflows, emphasizing PR review and approval before merge.

Why

This appendix keeps the primitives matrix consistent across supported agent environments and provides a practical mapping for teams adopting Devin while following the same loop-engineering patterns used throughout the repository.

Closes #200

Map loop primitives to Devin's Scheduled Sessions, Playbooks, Connectors,
Managed Devins (sub-agents), and Knowledge base.

- Scheduling: Scheduled Sessions + API trigger for cron syntax
- Skills: Playbooks as SKILL.md equivalent
- State: Knowledge base + committed STATE.md spine
- Sub-agents: Managed Devins + Devin Review for maker/checker split
- PR-only writes: explicit table row — open PRs, never push to main
- Week-one Daily Triage prompt (report-only, L1, no code writes)
- Human gate callout for L2+: PRs always need human review before merge

Closes cobusgreyling#200
@github-actions

Copy link
Copy Markdown
Contributor

Thanks @Mahizhan-S for contributing a docs improvement — visible, reviewable PRs like this grow the reference for everyone.

What happens next

  • Maintainer aims for same-day review on story, adopter, and scoped docs/example PRs (CONTRIBUTING.md).
  • good first issue PRs: comment on the linked issue so we can assign and close on merge.

More ways to help

— loop-engineering maintainers

@cobusgreyling
cobusgreyling merged commit b947dfd into cobusgreyling:main Jul 19, 2026
3 checks passed
@cobusgreyling

Copy link
Copy Markdown
Owner

Thanks @Mahizhan-S — merged.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Add Devin appendix to primitives matrix

2 participants