# Cognitive OS Starter Kit

A minimal, file-based operating kit for solo operators building AI agent workflows with inspectable memory and human judgment gates.

## What's included

1. `cognitive-os-starter-filesystem.md` — a small folder structure for memory, workflows, agents, projects, and reviews.
2. `agent-role-card-template.md` — a reusable role card for bounded agent responsibilities.
3. `decision-log-template.md` — a compact record for decisions agents should not rediscover.
4. `weekly-agent-review-template.md` — a weekly loop for turning agent activity into memory, constraints, and workflow improvements.

## How to use it

1. Create a `/cognitive-os` folder in your normal workspace.
2. Copy the filesystem template first.
3. Add one agent role card for a role you already use often: researcher, editor, operator, reviewer, or customer analyst.
4. Start a decision log before the next important workflow change.
5. Run the weekly review after seven days of agent work.

## Operating principle

Do not start by building a complex agent platform. Start by making the context around the agent inspectable.

Files first. Memory second. Automation third. Judgment always.