ultanio/cobot
4
1
Fork 4
Code Issues 84 Pull requests 10 Projects Releases Packages Wiki Activity Actions

docs: add AGENTS.md for AI agent contributors #84

Merged
k9ert merged 1 commit from nazim/cobot:add-agents-md into main 2026-02-22 21:07:52 +00:00
Conversation 0 Commits 1 Files changed 1 +120
nazim commented 2026-02-22 19:25:10 +00:00
Contributor
Copy link

What

Adds AGENTS.md — a guide for AI agents working on this codebase.

Why

The repo has great docs for humans (CONTRIBUTING.md) and for agents using cobot (docs/for-agents.md), but nothing for agents developing cobot. An agent cloning this repo doesn't know:

  • Where to start reading
  • What's safe to change
  • What the current priorities are
  • How to run tests (and which to skip)

What's in it

  • Repo layout with "start here" pointers
  • Architecture in 60 seconds
  • Current priorities (security audit reference)
  • Risk levels for different areas of the codebase
  • Code style and PR checklist
  • Clear "don't" list
## What Adds `AGENTS.md` — a guide for AI agents working on this codebase. ## Why The repo has great docs for humans (`CONTRIBUTING.md`) and for agents *using* cobot (`docs/for-agents.md`), but nothing for agents *developing* cobot. An agent cloning this repo doesn't know: - Where to start reading - What's safe to change - What the current priorities are - How to run tests (and which to skip) ## What's in it - Repo layout with "start here" pointers - Architecture in 60 seconds - Current priorities (security audit reference) - Risk levels for different areas of the codebase - Code style and PR checklist - Clear "don't" list
docs: add AGENTS.md for AI agent contributors
Some checks failed
E2E Tests / e2e (pull_request) Failing after 5s
Details
CI / test (3.11) (pull_request) Failing after 5s
Details
CI / test (3.12) (pull_request) Failing after 5s
Details
CI / test (3.13) (pull_request) Failing after 5s
Details
CI / lint (pull_request) Failing after 4s
Details
CI / build (pull_request) Has been skipped
Details
CI / docker (pull_request) Has been skipped
Details
f96b244737
nazim force-pushed add-agents-md from f96b244737
Some checks failed
E2E Tests / e2e (pull_request) Failing after 5s
Details
CI / test (3.11) (pull_request) Failing after 5s
Details
CI / test (3.12) (pull_request) Failing after 5s
Details
CI / test (3.13) (pull_request) Failing after 5s
Details
CI / lint (pull_request) Failing after 4s
Details
CI / build (pull_request) Has been skipped
Details
CI / docker (pull_request) Has been skipped
Details
to 46e7f9474b
All checks were successful
CI / lint (pull_request) Successful in 9s
Details
CI / test (3.11) (pull_request) Successful in 21s
Details
CI / test (3.12) (pull_request) Successful in 23s
Details
CI / test (3.13) (pull_request) Successful in 24s
Details
E2E Tests / e2e (pull_request) Successful in 14s
Details
CI / build (pull_request) Successful in 6s
Details
2026-02-22 19:52:02 +00:00 Compare
k9ert merged commit d3dfa0653b into main 2026-02-22 21:07:52 +00:00
Sign in to join this conversation.
Reviewers
No reviewers
Labels
Clear labels   
Compat/Breaking

Breaking change that won't be backward compatible

  
Kind/Bug

Something is not working

  
Kind/Competitor

Anything we found interesting at competitory

  
Kind/Documentation

Documentation changes

  
Kind/Enhancement

Improve existing functionality

  
Kind/Epic

Business requirement — groups related stories

  
Kind/Feature

New functionality

  
Kind/Security

This is security issue

  
Kind/Story

Implementable unit with AC — results in a PR

  
Kind/Testing

Issue or pull request related to testing

  
Priority
Critical
The priority is critical

  
Priority
High
The priority is high

  
Priority
Low
The priority is low

  
Priority
Medium
The priority is medium

  
Reviewed
Confirmed
Issue has been confirmed

  
Reviewed
Duplicate
This issue or pull request already exists

  
Reviewed
Invalid
Invalid issue

  
Reviewed
Won't Fix
This issue won't be fixed

  
Scope/Core

Changes to core non-plugin code (CLI, config loading, etc.).

  
Scope/Cross-Plugin

Touches multiple existing plugins. Needs extra scrutiny, may require a PRD.

  
Scope/Plugin-System

Changes to plugin infrastructure (base.py, registry.py, interfaces.py, __init__.py, agent.py plugin dispatch). PRD required before merge.

  
Scope/Single-Plugin

Changes contained to one plugin (or adds one new plugin). Standard review.

  
Status
Abandoned
Somebody has started to work on this but abandoned work

  
Status
Blocked
Something is blocking this issue or pull request

  
Status
Need More Info
Feedback is required to reproduce issue or to continue work

No labels
Compat/Breaking
Kind/Bug
Kind/Competitor
Kind/Documentation
Kind/Enhancement
Kind/Epic
Kind/Feature
Kind/Security
Kind/Story
Kind/Testing
Priority
Critical
Priority
High
Priority
Low
Priority
Medium
Reviewed
Confirmed
Reviewed
Duplicate
Reviewed
Invalid
Reviewed
Won't Fix
Scope/Core
Scope/Cross-Plugin
Scope/Plugin-System
Scope/Single-Plugin
Status
Abandoned
Status
Blocked
Status
Need More Info
Milestone
Clear milestone
No items
No milestone
Projects
Clear projects
No items
No project
Assignees
Clear assignees
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
ultanio/cobot!84
No description provided.