Student Guides

Scaffolded guides that walk you through increasingly complex contributions to the FEAST codebase. Each guide pairs with a week of the onboarding curriculum.

Weeks 1-2: Foundations

  1. Environment Setup – git fundamentals, clone repos, configure tools, run the app locally
  2. Filing Good Issues – write clear, actionable bug reports and feature requests
  3. Adding Type Hints – annotate function signatures and add docstrings
  4. Setting Up Linting – configure flake8 and pre-commit hooks

Weeks 3-4: Real Contributions

  1. Writing Tests – add unit and integration tests
  2. Investigating Bugs – trace, diagnose, and fix a real bug
  3. Optimizing Performance – profile and speed up the simulation step function

Weeks 5-6: Independence

  1. Adversarial Code Review – stress-test LLM-generated code
  2. Self-Directed Work – choose and complete a contribution independently

Reference Guides

  1. Deployment Configuration – understand how frontend, backend, and database connect across environments
  2. Structured Planning with CLI Agents – when and how to use structured planning, multi-issue planning, and branch-level review
  3. Agentic Engineering Concepts – what agents are, how they work, and why the focus shifts from syntax to engineering
  4. Agentic Workflow Best Practices – the complete spec-plan-execute-verify loop, workflow selection by task size, and a printable checklist