# DoctorWkt/acwj

A Compiler Writing Journey

Repository: https://github.com/DoctorWkt/acwj
Canonical: https://ross.abutalabs.com/products/acwj
Language: C
License: GPL-3.0
License Family: copyleft
Topics: compiler, lexical-analysis, parsing, c
Last push: 2026-06-06T21:17:51+00:00

## Health v2 (maintenance only)
Score: 71/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 86, release rhythm 35, longevity 100
- inputs: {"age_days": 2511, "days_push": 88, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_releases
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 13389, forks 1203 (observed 2026-08-28T04:11:03.238816+00:00)

## What it is
A step-by-step tutorial series documenting the journey of writing a self-compiling compiler for a subset of C, with detailed explanations of each stage from lexical scanning to code generation. Each part includes working C code and practical commentary with references to compiler theory.

## Use cases
- learn how to write a compiler from scratch
- understand lexical analysis and parsing
- build a compiler for a C subset
- learn how compilers generate assembly code
- study compiler construction with practical examples
- follow a hands-on compiler tutorial

## When to choose
- you want a practical, code-first introduction to compiler writing
- you prefer learning by building incrementally with explanations
- you want to see how a self-compiling C compiler comes together step by step

## When to avoid
- you need a production-ready compiler or full C standard compliance
- you want deep formal compiler theory rather than a practical walkthrough
- you need a compiler for languages other than the C subset covered

## Facets
- artifact type: learning-resource
- maturity: active
- function: compiler, parser, interpreter, documentation
- domain: compilers, programming-languages, parsers, tutorials, education
- platform: cpp, cli
- tags: compiler-writing, lexical-analysis, code-generation, self-compiling-compiler, c-subset, tutorial-series, assembly-generation, linux

## Member repositories
- DoctorWkt/acwj (main) score 71

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:11:03.238816+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T17:13:19.968082+00:00, confidence not recorded.
  - readme: https://github.com/DoctorWkt/acwj (fetched 2026-08-28T04:11:03.238816+00:00, sha c9e4f672e886)
- Data as of 2026-08-30T08:39:29.467469+00:00.