Skip to content

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

Open
Mahizhan-S wants to merge 1 commit into
cobusgreyling:mainfrom
Mahizhan-S:docs/devin-appendix-primitives-matrix
Open

docs: add Devin appendix to primitives matrix (#200)#307
Mahizhan-S wants to merge 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

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

1 participant