Research and Documentation

Research and Documentation

Nakagawa's documentation is intentionally split across project, engineering, and research surfaces.

Need	Go here
Understand or build Nakagawa	This GitHub Wiki and the public repository README/SETUP guides
Read current source	The repository, especially tools/, src/rt/, src/ref/, fixtures/, and docs/
Track a concrete defect or acceptance criterion	GitHub Issues
Review an implementation change	Pull requests
Ask a question or propose a replication/experiment	GitHub Discussions
PSP thread creation and start semantics	PSP Threading Semantics, with the general ThreadMan and Scheduler Model
General PSP reference and static-recompilation theory	Research Knowledge Base
Evidence vocabulary and claim discipline	Evidence Standard
Hardware finding	Hardware Findings Registry
Experiment record	Experiments Registry
Safe replication request	Hardware Replication and Replication Wanted
Runbook for a new measurement	How to Run a PSP Research Experiment
Submit a redacted result	Submitting Results Safely
Open questions and result-free plans	Open Research and Planned Experiments
Prior art and sources	Prior Art and Sources

Avoid duplication

Use the Wiki for Nakagawa-specific commands, source ownership, runtime boundaries, contributor workflow, and publication rules. Use the research site for generalized PSP architecture, hardware results, experiment methodology, contradictions, and teaching material. Keep actionable engineering work in Issues/PRs rather than maintaining a second task tracker in either documentation surface.

Start with Home, then Getting Started for the project path. For the broader PSP map, use the research site's Start Here.