# ForgeLearn — TypeScript Documentation Index for AI Agents

> TypeScript curriculum, types encyclopedia, and markdown API entry points for learning and generating correct, strict TypeScript.

## Permanent agent connection

- Connect: https://forgelearn.dev/api/agent
- TypeScript skill: https://forgelearn.dev/api/agent?skill=forgelearn-typescript
- Ordered curriculum: https://forgelearn.dev/api/agent?curriculum=typescript
- Skill file: https://forgelearn.dev/skills/forgelearn-typescript/SKILL.md
- Platform skill: https://forgelearn.dev/skills/forgelearn/SKILL.md
- Docs: https://forgelearn.dev/docs/agents
- Discovery: https://forgelearn.dev/.well-known/agent.json

```bash
curl -s https://forgelearn.dev/api/agent
curl -s https://forgelearn.dev/api/agent?curriculum=typescript
curl -s "https://forgelearn.dev/api/markdown?path=typescript/mastery"
curl -s https://forgelearn.dev/skills/forgelearn-typescript/SKILL.md -o SKILL.md
```

## Start here (mastery)

- [How to Master TypeScript](https://forgelearn.dev/docs/typescript/mastery): Dual-audience curriculum for humans and AI agents — stages, checkpoints, verification prompts
- Markdown: https://forgelearn.dev/api/markdown?path=typescript/mastery
- [Complete Types Reference](https://forgelearn.dev/docs/typescript/types-reference): Encyclopedia of the type system
- [TypeScript Roadmap](https://forgelearn.dev/docs/roadmaps/typescript): Topics from mastery to production
- Section bundle: https://forgelearn.dev/api/markdown?section=typescript

## How agents should ingest

1. Connect permanently: `GET /api/agent` (bookmark this)
2. Install skill: fetch `/skills/forgelearn-typescript/SKILL.md`
3. Fetch ordered curriculum: `/api/agent?curriculum=typescript`
4. Fetch the mastery page markdown: `/api/markdown?path=typescript/mastery`
5. Follow Stages 0–7 in order (see mastery curriculum)
6. For each topic: GET `/api/markdown?path=typescript/<topic>`
7. Types encyclopedia: `/api/markdown?path=typescript/types-reference`
8. Bulk ingest entire TypeScript track: `/api/markdown?section=typescript`
9. Self-verify with generation tasks after each stage — do not claim mastery from outlines alone
10. List all paths: `/api/markdown?list=true`

## Core TypeScript docs

- [How to Master TypeScript](https://forgelearn.dev/docs/typescript/mastery): Dual-audience TypeScript curriculum for humans and AI agents — stages, checkpoints, verification prompts
- [Complete Types Reference](https://forgelearn.dev/docs/typescript/types-reference): Encyclopedia of TypeScript types — primitives, utilities, keyof/infer, mapped, conditional, satisfies
- [Variance](https://forgelearn.dev/docs/typescript/variance): Covariance, contravariance, in/out annotations, readonly arrays
- [Branded Types](https://forgelearn.dev/docs/typescript/branded-types): Opaque/branded types, nominal patterns, Zod brand, validation boundaries
- [Module Augmentation](https://forgelearn.dev/docs/typescript/module-augmentation): Declaration merging, module/global augmentation, ambient modules
- [typescript-eslint](https://forgelearn.dev/docs/typescript/eslint): Type-checked ESLint setup, strict rules, ignore patterns, common fixes
- [Testing with TypeScript](https://forgelearn.dev/docs/typescript/testing): Vitest + TS, typed mocks, Testing Library, assertion helpers
- [Monorepo TypeScript](https://forgelearn.dev/docs/typescript/monorepo): Project references deep dive, pnpm workspaces, path mapping pitfalls
- [Design Patterns](https://forgelearn.dev/docs/typescript/patterns): Builder, Result/Either, exhaustive switches, DI typing, generic factories
- [JS→TS Migration](https://forgelearn.dev/docs/typescript/migration): allowJs, checkJs, gradual strict, converting CommonJS
- [0 to Hero](https://forgelearn.dev/docs/typescript): TypeScript introduction, setup, basic type annotations
- [Basics](https://forgelearn.dev/docs/typescript/types): Primitive types, arrays, tuples, type annotations
- [Type Inference](https://forgelearn.dev/docs/typescript/inference): How TypeScript infers types, best practices
- [Literals & Unions](https://forgelearn.dev/docs/typescript/literals): Literal types, union types, discriminated unions
- [Enums](https://forgelearn.dev/docs/typescript/enums): Numeric and string enums, const enums, reverse mappings
- [Functions](https://forgelearn.dev/docs/typescript/functions): Function type annotations, return types, void
- [Overloads](https://forgelearn.dev/docs/typescript/overloads): Function overloading signatures, implementation
- [Generics](https://forgelearn.dev/docs/typescript/generics): Generic functions, constraints, defaults, utility
- [Objects & Types](https://forgelearn.dev/docs/typescript/interfaces): Interface declarations, extending, merging
- [Type Aliases](https://forgelearn.dev/docs/typescript/type-aliases): Type keyword, intersection types, complex types
- [Utility Types](https://forgelearn.dev/docs/typescript/utility-types): Partial, Required, Pick, Omit, Record, Readonly
- [Classes](https://forgelearn.dev/docs/typescript/classes): Class syntax, properties, methods, constructors
- [Abstract & Modifiers](https://forgelearn.dev/docs/typescript/abstract): Abstract classes, access modifiers, readonly
- [Narrowing & Validation](https://forgelearn.dev/docs/typescript/narrowing): Control flow narrowing, type guards, assertion functions, discriminated unions
- [satisfies Operator](https://forgelearn.dev/docs/typescript/satisfies): satisfies vs as — inference preservation while checking assignability
- [Zod + TypeScript](https://forgelearn.dev/docs/typescript/zod): Runtime validation with Zod schemas, z.infer, API boundaries
- [Advanced](https://forgelearn.dev/docs/typescript/advanced): Conditional type logic, infer keyword, distributive
- [Mapped Types](https://forgelearn.dev/docs/typescript/mapped): Mapping over types, key remapping, modifiers
- [Template Literals](https://forgelearn.dev/docs/typescript/template-literals): Template literal types, string manipulation
- [Type Guards](https://forgelearn.dev/docs/typescript/type-guards): typeof, instanceof, in, custom type guards
- [Strict, React & Tooling](https://forgelearn.dev/docs/typescript/strict): Enable strict flags one-by-one, migrate JS→TS safely
- [React + TypeScript](https://forgelearn.dev/docs/typescript/react): Props, hooks typing, events, generic components
- [tsconfig](https://forgelearn.dev/docs/typescript/config): tsconfig.json options, compiler flags, strict mode
- [Declaration Files](https://forgelearn.dev/docs/typescript/declarations): .d.ts files, ambient declarations, DefinitelyTyped
- [Project References](https://forgelearn.dev/docs/typescript/project-refs): Multi-package projects, incremental compilation
- [Decorators](https://forgelearn.dev/docs/typescript/decorators): Stage 3 decorators, class/method decorators
- [Module Resolution](https://forgelearn.dev/docs/typescript/modules): Resolution algorithms, path mapping, barrel exports
- [Iteration Protocols](https://forgelearn.dev/docs/typescript/iteration): Iterable, iterator, async iteration, generators
- [never & unknown Types](https://forgelearn.dev/docs/typescript/never-unknown): Top/never types, exhaustive checks, type narrowing
- [Best Practices](https://forgelearn.dev/docs/typescript/best-practices): TypeScript best practices, strict config, patterns, and code review checklist

## Related

- JavaScript: https://forgelearn.dev/llms-js.txt
- HTML: https://forgelearn.dev/llms-html.txt
- CSS: https://forgelearn.dev/llms-css.txt