Skip to content
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,14 @@ title: Rust Mindset, Toolchain, and Engineering Loop
track: rust-engineering
level: foundation
version: 1.0
Prerequisites: "Comfort with a programming language; basic command-line use; no prior Rust required"
Duration: "~2-3 hours (install + first artifact)"
Format: "Setup + small CLI build (task-normalize) + reflection on compiler error layers + Watch First video"
Future_Topics: "Rust Syntax Fast Start, Ownership Borrowing Lifetimes, Data Modeling Errors"
Related_docs:
- 01-foundations/03-tooling/02-version-control
- 02-rust-syntax-fast-start
- 07-agent-systems/02-llm-orchestration
---

# Rust Mindset, Toolchain, and Engineering Loop
Expand Down
8 changes: 8 additions & 0 deletions curriculum/06-rust-engineering/02-rust-syntax-fast-start.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,14 @@ title: Rust Syntax Fast Start
track: rust-engineering
level: foundation
version: 1.0
Prerequisites: "01-rust-mindset-toolchain-engineering-loop (or equivalent toolchain familiarity); programming experience in any language"
Duration: "~2-3 hours"
Format: "Reading + build task_summary program + 3 small tests + Watch First video"
Future_Topics: "Ownership Borrowing Lifetimes Memory Thinking, Data Modeling Errors Control Flow"
Related_docs:
- 01-rust-mindset-toolchain-engineering-loop
- 03-ownership-borrowing-lifetimes-memory-thinking
- 04-data-modeling-errors-control-flow
---

# Rust Syntax Fast Start
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,14 @@ title: Ownership, Borrowing, Lifetimes, and Memory Thinking
track: rust-engineering
level: foundation
version: 1.0
Prerequisites: "02-rust-syntax-fast-start (or equivalent syntax familiarity)"
Duration: "~3-4 hours (heavier cognitive load)"
Format: "Reading + memory-responsibility sketch + refactor exercise (Vec<Task> to borrowed/mutably-borrowed/consuming) + AI code review pass + Watch First video"
Future_Topics: "Data Modeling Errors, Reuse Without OOP, Smart Pointers Concurrency, Macros and Unsafe"
Related_docs:
- 02-rust-syntax-fast-start
- 04-data-modeling-errors-control-flow
- 07-smart-pointers-shared-state-concurrency
---

# Ownership, Borrowing, Lifetimes, and Memory Thinking
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,15 @@ title: Data Modeling, Errors, and Control Flow
track: rust-engineering
level: foundation
version: 1.0
Prerequisites: "02-rust-syntax-fast-start, 03-ownership-borrowing-lifetimes-memory-thinking"
Duration: "~3 hours"
Format: "Reading + state-machine build (TaskStatus enum) + transition test suite + AI prompt review + Watch First video"
Future_Topics: "Reuse Without OOP, Service-Layer Architecture, Macros and Unsafe"
Related_docs:
- 03-ownership-borrowing-lifetimes-memory-thinking
- 05-reuse-without-oop
- 11-service-layer-architecture-domain-boundaries
- 04-Protocol Engineering/01-beginner/01-protocol-concepts/02-state-machines
---

# Data Modeling, Errors, and Control Flow
Expand Down
8 changes: 8 additions & 0 deletions curriculum/06-rust-engineering/05-reuse-without-oop.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,14 @@ title: Reuse Without OOP
track: rust-engineering
level: foundation
version: 1.0
Prerequisites: "02-rust-syntax-fast-start, 03-ownership-borrowing-lifetimes-memory-thinking, 04-data-modeling-errors-control-flow"
Duration: "~3-4 hours"
Format: "Reading + small domain crate + newtype refactor (String IDs to TaskId/UserId) + AI output critique + Watch First video"
Future_Topics: "Modules Crates Workspaces, Persistence Reusable CRUD, Service-Layer Architecture"
Related_docs:
- 04-data-modeling-errors-control-flow
- 06-modules-crates-workspaces-project-shape
- 10-persistence-reusable-crud-sqlx
---

# Reuse Without OOP
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,15 @@ title: Modules, Crates, Workspaces, and Project Shape
track: rust-engineering
level: foundation
version: 1.0
Prerequisites: "01-rust-mindset-toolchain-engineering-loop through 05-reuse-without-oop"
Duration: "~2-3 hours"
Format: "Reading + workspace migration (rust-lab layout: api/domain/application/infrastructure/workers/shared) + ADR 0001 write-up + Watch First video"
Future_Topics: "Smart Pointers Concurrency, Service-Layer Architecture, Scaffolding Lab"
Related_docs:
- 05-reuse-without-oop
- 07-smart-pointers-shared-state-concurrency
- 11-service-layer-architecture-domain-boundaries
- 12-application-framework-scaffolding-lab
---

# Modules, Crates, Workspaces, and Project Shape
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,14 @@ title: Smart Pointers, Shared State, and Concurrency Basics
track: rust-engineering
level: intermediate
version: 1.0
Prerequisites: "03-ownership-borrowing-lifetimes-memory-thinking, 04-data-modeling-errors-control-flow, 05-reuse-without-oop"
Duration: "~3-4 hours"
Format: "Reading + event counter build (Arc<Mutex<Vec<Event>>> to producer-channel + worker-owning-counter) + concurrent-send tests + Watch First video"
Future_Topics: "Async Rust and Tokio, Observability Performance Deployment, Service-Layer Architecture"
Related_docs:
- 06-modules-crates-workspaces-project-shape
- 08-async-rust-and-tokio
- 15-observability-performance-deployment
---

# Smart Pointers, Shared State, and Concurrency Basics
Expand Down
8 changes: 8 additions & 0 deletions curriculum/06-rust-engineering/08-async-rust-and-tokio.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,14 @@ title: Async Rust and Tokio
track: rust-engineering
level: intermediate
version: 1.0
Prerequisites: "07-smart-pointers-shared-state-concurrency"
Duration: "~4 hours"
Format: "Reading + bounded worker pool build (max 4 jobs) + per-job timeouts + shutdown signal tests + Watch First video"
Future_Topics: "Axum Web Engineering, Security and API Safety, Observability Performance Deployment"
Related_docs:
- 07-smart-pointers-shared-state-concurrency
- 09-axum-first-web-engineering
- 14-security-authentication-api-safety
---

# Async Rust and Tokio
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,15 @@ title: Axum-First Web Engineering
track: rust-engineering
level: intermediate
version: 1.0
Prerequisites: "06-modules-crates-workspaces-project-shape, 07-smart-pointers-shared-state-concurrency, 08-async-rust-and-tokio"
Duration: "~4-5 hours"
Format: "Reading + Axum endpoint build (/health, /tasks, /artifacts, /jobs) + handler refactor + OpenAPI generation + Watch First video"
Future_Topics: "Persistence Reusable CRUD, Service-Layer Architecture, Scaffolding Lab, Security and API Safety"
Related_docs:
- 08-async-rust-and-tokio
- 10-persistence-reusable-crud-sqlx
- 11-service-layer-architecture-domain-boundaries
- 12-application-framework-scaffolding-lab
---

# Axum-First Web Engineering
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,15 @@ title: Persistence and Reusable CRUD With SQLx
track: rust-engineering
level: intermediate
version: 1.0
Prerequisites: "06-modules-crates-workspaces-project-shape, 09-axum-first-web-engineering"
Duration: "~5 hours"
Format: "Reading + repository build (Task/Artifact/JobRun CRUD) + typed-query task listing + pagination refactor + AI generic-CRUD review + Watch First video"
Future_Topics: "Service-Layer Architecture, Testing Fixtures and Code Review Culture, Persistence Deep Dive"
Related_docs:
- 09-axum-first-web-engineering
- 11-service-layer-architecture-domain-boundaries
- 13-testing-fixtures-code-review-culture
- 04-Protocol Engineering/01-beginner/02-standards/03-interoperable-design
---

# Persistence and Reusable CRUD With SQLx
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,14 @@ title: Service-Layer Architecture and Domain Boundaries
track: rust-engineering
level: intermediate
version: 1.0
Prerequisites: "09-axum-first-web-engineering, 10-persistence-reusable-crud-sqlx"
Duration: "~3-4 hours"
Format: "Reading + vertical-slice refactor (DTO/command/service/repo/response/tests) + Mermaid dependency diagram + Watch First video"
Future_Topics: "Scaffolding Lab, Security and API Safety, Testing Fixtures and Code Review Culture"
Related_docs:
- 10-persistence-reusable-crud-sqlx
- 12-application-framework-scaffolding-lab
- 14-security-authentication-api-safety
---

# Service-Layer Architecture and Domain Boundaries
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,14 @@ title: Application Framework and Scaffolding Lab
track: rust-engineering
level: intermediate
version: 1.0
Prerequisites: "09-axum-first-web-engineering, 10-persistence-reusable-crud-sqlx, 11-service-layer-architecture-domain-boundaries"
Duration: "~3 hours"
Format: "Optional lab - install scaffold CLI + generate resource + write comparison report (manual slice vs generated slice) + Watch First video"
Future_Topics: "Testing Fixtures and Code Review Culture, AI-Assisted Rust Engineering, Production Service Capstone"
Related_docs:
- 11-service-layer-architecture-domain-boundaries
- 13-testing-fixtures-code-review-culture
- 18-ai-assisted-rust-engineering
---

# Application Framework and Scaffolding Lab
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,15 @@ title: Testing, Fixtures, and Code Review Culture
track: rust-engineering
level: intermediate
version: 1.0
Prerequisites: "09-axum-first-web-engineering, 10-persistence-reusable-crud-sqlx, 11-service-layer-architecture-domain-boundaries"
Duration: "~3-4 hours"
Format: "Reading + test suite build (unit/integration/HTTP/DB/smoke) + AI test-patch review + Watch First video"
Future_Topics: "Security and API Safety, Production Service Capstone, AI-Assisted Rust Engineering"
Related_docs:
- 11-service-layer-architecture-domain-boundaries
- 14-security-authentication-api-safety
- 18-ai-assisted-rust-engineering
- 02-Blockchain/02-intermediate/01-smart-contracts/03-testing-and-deployment
---

# Testing, Fixtures, and Code Review Culture
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,15 @@ title: Security, Authentication, and API Safety
track: rust-engineering
level: intermediate
version: 1.0
Prerequisites: "09-axum-first-web-engineering, 11-service-layer-architecture-domain-boundaries, 13-testing-fixtures-code-review-culture"
Duration: "~4 hours"
Format: "Reading + auth-aware route build (POST /tasks, GET /tasks/mine, admin DELETE) + policy function + supply-chain audit + Watch First video"
Future_Topics: "Observability Performance Deployment, Production Service Capstone, 05-products Security and Trust Engineering"
Related_docs:
- 13-testing-fixtures-code-review-culture
- 15-observability-performance-deployment
- 05-products/07-security-trust-engineering
- 04-Protocol Engineering/03-advanced/01-lead-architect/03-security-modeling
---

# Security, Authentication, and API Safety
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,15 @@ title: Observability, Performance, and Deployment
track: rust-engineering
level: advanced
version: 1.0
Prerequisites: "09-axum-first-web-engineering, 11-service-layer-architecture-domain-boundaries, 14-security-authentication-api-safety"
Duration: "~4-5 hours"
Format: "Reading + tracing setup (/health, /ready) + structured error logs + multi-stage Dockerfile + CI workflow + Watch First video"
Future_Topics: "Beyond Backend, Production Service Capstone, 04-Protocol Engineering Performance Auditing"
Related_docs:
- 14-security-authentication-api-safety
- 16-beyond-backend-cli-data-protocols-wasm-embedded
- 19-production-service-capstone
- 04-Protocol Engineering/03-advanced/02-global-adoption/02-performance-auditing
---

# Observability, Performance, and Deployment
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,15 @@ title: Beyond Backend
track: rust-engineering
level: advanced
version: 1.0
Prerequisites: "02-rust-syntax-fast-start, 03-ownership-borrowing-lifetimes-memory-thinking, 04-data-modeling-errors-control-flow, 05-reuse-without-oop"
Duration: "~3-4 hours"
Format: "Reading + CLI build (taskctl summarize events.jsonl streaming JSONL) + parser tradeoff note + Watch First video"
Future_Topics: "Macros Unsafe Escape Hatches, AI-Assisted Rust Engineering, 04-Protocol Engineering Beyond Backend"
Related_docs:
- 05-reuse-without-oop
- 17-macros-unsafe-advanced-escape-hatches
- 18-ai-assisted-rust-engineering
- 04-Protocol Engineering/01-beginner/01-protocol-concepts/01-protocol-vs-application
---

# Beyond Backend
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,15 @@ title: Macros, Unsafe Rust, and Advanced Escape Hatches
track: rust-engineering
level: advanced
version: 1.0
Prerequisites: "03-ownership-borrowing-lifetimes-memory-thinking, 04-data-modeling-errors-control-flow, 05-reuse-without-oop; comfort with intermediate Rust"
Duration: "~3 hours"
Format: "Reading + small macro (test-setup) + review-note decision (justify or delete) + Watch First video"
Future_Topics: "AI-Assisted Rust Engineering, Production Service Capstone, Macros in AI-generated code review"
Related_docs:
- 05-reuse-without-oop
- 16-beyond-backend-cli-data-protocols-wasm-embedded
- 18-ai-assisted-rust-engineering
- 19-production-service-capstone
---

# Macros, Unsafe Rust, and Advanced Escape Hatches
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,15 @@ title: AI-Assisted Rust Engineering
track: rust-engineering
level: advanced
version: 1.0
Prerequisites: "09-axum-first-web-engineering, 10-persistence-reusable-crud-sqlx, 11-service-layer-architecture-domain-boundaries, 12-application-framework-scaffolding-lab, 13-testing-fixtures-code-review-culture, 14-security-authentication-api-safety"
Duration: "~3-4 hours"
Format: "Reading + AI-generated patch (Artifact CRUD) + human review transcript + ADR + Watch First video"
Future_Topics: "Production Service Capstone, ongoing model/tooling evolution, AI smell list refinement"
Related_docs:
- 17-macros-unsafe-advanced-escape-hatches
- 19-production-service-capstone
- 07-agent-systems/02-llm-orchestration
- 07-agent-systems/07-evaluating-agents
---

# AI-Assisted Rust Engineering
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,15 @@ title: Production Service Capstone
track: rust-engineering
level: advanced
version: 1.0
Prerequisites: "01-rust-mindset-toolchain-engineering-loop through 18-ai-assisted-rust-engineering"
Duration: "~15-25 hours (capstone-level effort)"
Format: "Solo project + public repo or reviewable bundle + architecture-first build (brief - ERD - route list - ADR - vertical slice) + Final Engineering Review"
Future_Topics: "Real-world extensions, Flow Research integration, custom domain adaptations, post-capstone improvement"
Related_docs:
- 18-ai-assisted-rust-engineering
- 15-observability-performance-deployment
- 14-security-authentication-api-safety
- 04-Protocol Engineering/03-advanced/02-global-adoption/03-enterprise-integration
---

# Production Service Capstone
Expand Down
2 changes: 1 addition & 1 deletion website/docusaurus.config.ts
Original file line number Diff line number Diff line change
Expand Up @@ -50,7 +50,7 @@ const config: Config = {
path: "../curriculum",
routeBasePath: "curriculum",
sidebarPath: "./sidebars.ts",
editUrl: "https://github.com/Flow-Research/learn/tree/main/",
editUrl:({ docPath }) => `https://github.com/Flow-Research/learn/edit/main/curriculum/${docPath}`,
remarkPlugins: [remarkMath],
rehypePlugins: [rehypeKatex],
sidebarItemsGenerator: async ({
Expand Down