π Living Project β Continuously updated with the latest AI-assisted development practices, patterns, and learnings.
Vue 3 Todo Dashboard β A reference implementation demonstrating multi-agent AI development with GitHub Copilot.
This project showcases how professional teams use AI to boost productivity while maintaining quality, safety, and developer control.
AI is a co-pilot, not an autopilot. You are responsible for code quality, security, and compliance.
| Responsibility | Action | |
|---|---|---|
| ποΈ | Review | Read and understand all AI-generated code before committing |
| β | Validate | Check against requirements and project standards |
| π§ͺ | Test | Run full test suite before merging |
| π | Security | Verify auth, credentials, and data handling |
| π‘ | Understand | Know what changed and why it changed |
π Read the full guide β β detailed checklists on developer accountability and AI-assisted workflows (see SECURITY.md for security and incident response)
New to this project? Begin with the AI Development Guide for a complete overview of agents, instructions, MCP, and how everything works together.
In This README:
- Developer Responsibilities β Your accountability when working AI-Assisted
- Getting Started β Run locally in 3 steps
- System Architecture β Visual overview
- Tech Stack β Technologies used
- Documentation β All learning resources
ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
β GitHub Copilot Agent Mode β
ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ€
β Agents (6) β Instructions (10) β Skills (11) β
β βββ Implement β βββ Global β βββ Architectural Docs β
β βββ Specify β βββ Backend Routes β βββ Backend Routes β
β βββ Test Unit β βββ Pinia Stores β βββ Code Documentation β
β βββ Test E2E β βββ Prisma Database β βββ E2E Testing β
β βββ Onboarding β βββ Styling β βββ Pinia Stores β
β βββ Socratic Mentor β βββ Testing Backend β βββ Prisma Database β
β β βββ Testing E2E β βββ Security Review β
β β βββ Testing Frontend β βββ Styling β
β β βββ Vue Components β βββ Unit Testing β
β β βββ Vue Composables β βββ Vue Components β
β β β βββ Vue Composables β
ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ€
β Prompts (10) β
β βββ Generate API Endpoint βββ Generate Pinia Store β
β βββ Generate Component βββ Generate Unit Test β
β βββ Generate E2E Test βββ Review Security β
β βββ Specify βββ Implement β
β βββ Onboard βββ Mentor β
ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ€
β MCP Integrations (4) β
β βββ Atlassian (Jira/Confluence) βββ Chrome DevTools β
β βββ Figma Desktop βββ Playwright β
ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
| Layer | Stack | Details |
|---|---|---|
| Frontend | Vue 3 + TypeScript + Vite | frontend/README.md |
| Backend | Express + Prisma + PostgreSQL | backend/README.md |
| Testing | Vitest, Playwright | Unit & E2E |
| AI | GitHub Copilot, Custom Agents, MCP | See docs/ |
- Node.js
>=22.12.0 - Docker (for PostgreSQL)
- VS Code with GitHub Copilot Extension
For a secure, isolated development environment, use Dev Containers:
- Install the Dev Containers extension
- Open Command Palette (
Cmd+Shift+P) β "Dev Containers: Reopen in Container" - Wait for container to build (first time takes ~2 minutes)
- Run
whoamiin terminal to verify non-root user (should shownode)
The container automatically installs dependencies, starts PostgreSQL, and runs migrations.
# Clone and install all dependencies
git clone <repository-url>
cd todo_app
npm run install:all
# Start backend (requires Docker)
cd backend
docker compose up -d
npm run db:migrate && npm run db:seed
npm run dev # API β http://localhost:3000
# Start frontend (new terminal)
cd frontend
npm run dev # App β http://localhost:5173| Command | Description |
|---|---|
npm run dev |
Start frontend & backend concurrently |
npm run install:all |
Install all dependencies |
npm run test |
Run all tests |
npm run test:e2e |
Run Playwright E2E tests |
π See frontend/README.md and backend/README.md for full command reference.
| Resource | Purpose |
|---|---|
| What is GitHub Copilot? | Overview and capabilities |
| Response Customization | Examples and best practices |
| Customization Cheat Sheet | Compare all customization features (instructions, agents, prompts, skills, MCP) |
| Trust Center | Security, privacy, and compliance |
| Resource | Purpose |
|---|---|
| MCP Official Site | Introduction and core concepts |
| MCP Architecture | How MCP works under the hood |
| Building MCP Servers | Create custom MCP integrations |
| Resource | Purpose |
|---|---|
| Awesome Copilot | Community examples and best practices |
| Customization Library | Official curated examples of customization features |
π Reference Implementation β This is a showcase project demonstrating professional practices for AI-assisted software development. It's designed for learning and as a template for your own AI-powered development workflows.
Skill-Level Awareness β The project includes training agents (@Onboarding, @socratic-mentor) that adapt to different developer skill levels, from juniors learning through Socratic questioning to seniors orchestrating full agent workflows. See the Skill Levels Guide for details.
Not for Production Use β This is a demonstration project. For production use, customize the agents, instructions, and security policies to match your organization's standards.
Code Quality Notice β While we strive to maintain the code quality standards expected at slashwhy, the experimental and educational nature of this project means quality cannot be guaranteed. Code in this repository does not necessarily reflect the production code quality expectations of slashwhy.
π§β
You remain responsible for your output, code quality, security, and compliance.