Week 5

March 15, 2026 · View on GitHub

Use the app in week5/ as your playground. This week mirrors the prior assignment but emphasizes the Warp agentic development environment and multi‑agent workflows.

Learn about Warp

Warp Agentic Development Environment: warp.dev
Warp University

Explore the Starter Application

Minimal full‑stack starter application.

FastAPI backend with SQLite (SQLAlchemy)
Static frontend (no Node toolchain needed)
Minimal tests (pytest)
Pre-commit (black + ruff)
Tasks to practice agent-driven workflows

Use this application as your playground to experiment with the Warp automations you build.

Structure

backend/                # FastAPI app
frontend/               # Static UI served by FastAPI
data/                   # SQLite DB + seed
docs/                   # TASKS for agent-driven workflows

Quickstart

Activate your conda environment.

conda activate cs146s

(Optional) Install pre-commit hooks

pre-commit install

Run the app (from week5/ directory)

make run

Open http://localhost:8000 for the frontend and http://localhost:8000/docs for the API docs.
Play around with the starter application to get a feel for its current features and functionality.

Testing

Run the tests (from week5/ directory)

make test

Formatting/Linting

make format
make lint

Part I: Build Your Automation (Choose 2 or more)

Select tasks from week5/docs/TASKS.md to implement. Your implementation must leverage Warp in both of the following ways (more details below):

A) Use Warp Drive features — such as saved prompts, rules, or MCP servers.
(B) Incorporate multi-agent workflows within Warp.

Keep your changes focused on backend, frontend, logic, or tests inside week5/. For each selected task, note its difficulty level.

A) Warp Drive saved prompts, rules, MCP servers (REQUIRED: at least one)

Create one or more shareable Warp Drive prompts, rules, or MCP server integrations tailored to this repo. Examples:

Test runner with coverage and flaky‑test re‑run
Docs sync: generate/update docs/API.md from /openapi.json, list route deltas
Refactor harness: rename a module, update imports, run lint/tests
Release helper: bump versions, run checks, prepare a changelog snippet
Integrate the Git MCP server to have Warp interact with Git autonomously (creating branches, commits, PR notes, etc)

Tips: keep workflows focused, pass arguments, make them idempotent, and prefer headless/non‑interactive steps where possible.

B) Multi‑agent workflows in Warp (REQUIRED: at least one)

Run a multi‑agent session where separate agents in different Warp tabs handle independent tasks concurrently.

Perform multiple self-contained tasks from TASKS.md in separate Warp tabs using concurrent agents. Challenge: how many agents can you have working simultaneously?

Tips: git worktree may be helpful here to keep agents from clobbering over each other.

Two or more Warp automations, which may include:
- Warp Drive workflows/rules (share links and/or exported definitions) and any helper scripts
- Any supplemental prompts/playbooks used to coordinate multiple agents
A write‑up writeup.md under week5/ that includes:
- Design of each automation, including goals, inputs/outputs, steps
- Before vs. after (i.e. manual workflow vs. automated workflow)
- Autonomy levels used for each completed task (which code permissions, why, and how you supervised)
- (if applicable) Multi‑agent notes: roles, coordination strategy, and concurrency wins/risks/failures
- How you used the automation (what pain point it resolves or accelerates)

SUBMISSION INSTRUCTIONS

Make sure you have all changes pushed to your remote repository for grading.
Make sure you've added both brentju and febielin as collaborators on your assignment repository.
Submit via Gradescope.