multiagent-spec-writer-pc

Proof of Concept — A local, multi-agent system where AI bots collaboratively gather software requirements through conversation and real-time note-taking.

Bots talking. Specs evolving.

📽️ Demo Video

Watch it in action:
🎥 AI BOTS PLAN SOFTWARE TOGETHER

🧠 What It Does

This project simulates a structured software planning session between autonomous AI agents:

• System Analyst Bot – Asks focused questions to clarify requirements.
• Business Owner Bot – Responds with goals, features, and constraints.
• Notes Assistant Bot – Maintains and updates a structured markdown document.

Each round, the Analyst and Owner exchange messages, and the Notes bot rewrites the spec based on the Q&A.

⚙️ Tech Stack

• Python 3
• Ollama (runs locally)
• gemma3:latest model
• File-based communication (notes saved to NOTES.md)

🚀 Getting Started

1. Install Ollama https://ollama.com/download

2. Pull the model

   ollama pull gemma3:latest
   

3. Clone and run

   git clone https://github.com/karsany/multiagent-spec-writer-pc.git
   cd multiagent-spec-writer-pc
   pip install -r requirements.txt
   python main.py

📒 Output

Each run generates an evolving NOTES.md with structured insights like:

🤔 Why?

LLMs are capable of more than single-response tasks. This is an experiment in cooperative AI workflows — structuring models to think, ask, and revise like a human team.

📌 Notes

• This is a proof of concept — useful in theory, but still evolving in practice.
• It runs fully local with no external APIs or data.
• It was built for fun — but it hints at something more powerful long-term.

🙋‍♂️ Feedback Welcome

Open an issue, drop a star ⭐, or message me with thoughts, questions, or ideas!