map

name	~map
description	Use only when the user explicitly types ~map. Generates or refreshes the hello-scholar native architecture map by invoking the architecture-map workflow, then validates and points to the local viewer.
policy	{"allow_implicit_invocation":false}

~map Command

Trigger: ~map [--lang zh|en] [optional focus]

Mission

Generate or refresh hello-scholar/architecture/architecture-map.json with the architecture-map skill. This is an in-agent command, not a terminal CLI subcommand.

Rules

• Load and follow the architecture-map skill.
• Follow ../../architecture/references/native-boundaries.md; this command writes hello-scholar native architecture assets only.
• Treat an optional focus argument as a perspective, subsystem, command, route, flow, or topic hint.
• Support --lang zh|en / --language zh|en as the requested map content language. If no language flag is present, ask the user to choose Chinese or English before generating or refreshing the map.
• Write the resolved content language to project.language. Use Chinese prose in Chinese mode except necessary English terms such as stable IDs, paths, commands, APIs, package names, schema enums, profile names, skill names, and code symbols.
• If hello-scholar/ is not initialized, ask the user to run ~init or hello-scholar init before writing architecture assets.
• Preserve existing map IDs when refreshing unless the concept truly changed.
• After generation, run hello-scholar map validate.

Completion Output

Report:

• generated or refreshed files
• selected perspectives
• validation errors and warnings
• unknowns and inferred edges worth verifying
• local viewer command

Then tell the user:

hello-scholar map view --lang auto