cobots

This repository contains my AI tooling setup; all my agent files, instruction files, and skills. Most of these, I've written myself (some with the help of AI). Others, I've copied and modified to my liking (I've added notes to each of these). This is primarily intended to be used with GitHub Copilot or other AI-assisted coding agent tools.

The name cobots comes from one (or all) of these:

• Connor's Bots
• Coding Bots
• Collaborating Bots
• Cool Binary Output Technicians
• Coordinated Operating Bots
• Confusing, overthought, binary-optimizing totality
• ...alright I'm out of ideas

The System

So far, the system of agents works like this:

• The Director understands the goals of a project/problem and comes up with a high-level plan of what tasks are involved, and what other agents should complete them.
• The Architect creates a comprehensive design report on how a software system should be design (or how a problem should be solved).
• The Developer implements the architect's design.
• The Scrutinizer reviews the implementation (or anything else requested) and suggests improvements to be made.
• The Documenter writes documentation for the project.
• The Researcher researches topics and produces research reports.

The following skills are used by the agents to track work and report progress:

• Cobots Tasks CLI - A small CLI tool that creates and manages *.task.md files under a working directory.
  • Tasks represent individual items that need completing for the project.
• Cobots Reports CLI - A small CLI tool that creates *.report.md files under a working directory.
  • Reports represent write-ups created by the agents, such as architecture plans, code reviews, etc.
• Cobots Ntfy CLI - A small CLI tool that uses ntfy.sh to send me notifications on agent progress, updates, questions, etc.
  • By default, it is configured to run in "confidential" mode, meaning that only generic messages can be sent via ntfy.sh (such as "build finished", "waiting for input", etc.).

Resources

A few useful resources that I've learned from:

• Awesome GitHub Copilot - A collection of agents, skills, instructions, etc.
• How to write a great agents.md