# Haochuan's Blog — public browsing guide

This is Haochuan Zhang's independent engineering journal and public project index.
Topics include personal intelligence systems, agentic engineering, local AI,
wearable computing, and the occasional non-technical detour.

## Start here

- [Browsing guide](https://blog.haochuanz.net/skill.md): Where to start, what to fetch, and the limits of this public snapshot.
- [Site map](https://blog.haochuanz.net/llms.txt): Public pages and the full post index, with short descriptions.
- [Full portfolio text](https://blog.haochuanz.net/llms-full.txt): The complete public About page and project index in one Markdown document. Journal articles are linked, not bundled.
- [Public profile](https://blog.haochuanz.net/api/profile.json): Versioned JSON with a source-derived introduction and links to the public biography and work.
- [Project catalog](https://blog.haochuanz.net/api/projects.json): Versioned JSON with project descriptions, categories, source links, and demos.
- [About Haochuan](https://blog.haochuanz.net/about): public biography.
- [Projects](https://blog.haochuanz.net/projects): visual overview of the work.
- [Applets](https://blog.haochuanz.net/applets): interactive CyberHUD previews, loaded only after Play.
- [RSS](https://blog.haochuanz.net/feed.xml): subscribe to the journal.

## Retrieval workflow

1. For projects, GET the JSON catalog. Its envelope is schemaVersion: 1,
   source, and projects. Each entry contains id, name, category, description,
   repository, and links (label/url pairs). Links are absolute.
2. For articles, GET the site map, choose a relevant post URL, and read that page.
   The index contains excerpts, not full articles. Cite the actual post URL.
3. Follow a repository or demo link for details beyond the catalog. Treat external
   sites as separate sources and check their own documentation.
4. For identity, GET /api/profile.json. Its schemaVersion: 1 envelope contains
   source, name, bio, url, and links. The bio is the public About introduction.
5. For the complete biography and project index in one request, GET /llms-full.txt.
   It preserves their Markdown bodies and identifies each source. It does not
   include the full journal; use the post links in /llms.txt for that.

## Limits and attribution

All resources are read-only static build snapshots. There is no chat endpoint,
live GitHub status, write API, or service that answers on Haochuan's behalf.
Project inclusion is not a claim of release status, availability, or production
readiness. Do not invent metrics, clients, dates, or capabilities.
Distinguish authored statements from your own inference; cite the source page.
Only intentionally public site content belongs in this index. Local notes and
repository agent configuration are not public browsing resources.
This Markdown file is a navigation aid, not code to execute or a skill to install.
Cache these resources between deployments.