docs: avatar swap (pixel-art) + full README cleanup pass#11
Merged
Conversation
Image: - archon-avatar.png: replaced realistic alien render with pixel-art variant (1024×1024 RGB, 456K). README line 4 reference unchanged. README: - Overview: binary size 55→66 MB (v0.1.13 actual), 22→23 themes - CLI Reference: removed kb/leann/--list-sessions (don't exist), added 17 missing subcommands (run-agent-async, task-status/result/ cancel/list/events, metrics, agent-list/search/info, pipeline code/research/status/resume/list/abort/run/cancel) and 12 missing flags. Verified against src/cli_args.rs at v0.1.13. - Slash Commands: rewrote against actual default_registry() — 64 primaries grouped into 9 categories. Added the 24 v0.1.6+ primaries the README never documented (/run-agent, /archon-code, /archon-research, /agent, /managed-agents, /refresh, /connect, /plugin, /reload-plugins, /files, /search, /summary, /extra-usage, /providers, /cancel, /voice, /exit, /skills, /session, /hooks, /mcp, /denials, /tag, /rules, /memory, /export, /teleport). - Built-in Skills section: documents the 30 skills from builtin.rs+expanded.rs (git-status, branch, pr, restore, undo, init, sessions, keybindings, statusline, insights, stats, security-review, feedback, schedule, remote-control, btw, refresh-identity) that the slash-command rewrite would otherwise have dropped. - Tools Reference: 40+→43 registered tools, 10→13 categories, per-tool permission level (Safe/Risky/Variable). Added missing tools (Monitor, PushNotification, ApplyPatch, CartographerScan, Skill). - Themes: 22→23 (added daltonized + auto utility entries). - Config: warn_threshold default 100.0→30.0 (actual default). - Agent Definition System: split into three formats — pipeline-style TOML+frontmatter (existing), flat-file YAML-frontmatter (v0.1.10+, was undocumented), and legacy 6-file directory. Added 7-tier priority order and field-mapping table. - KB section CLI subsection: rewrote to reflect that `archon kb` subcommand does NOT exist; access is via the research pipeline. - Release Notes (NEW): full v0.1.6 → v0.1.13 changelog with PR references and root-cause notes for each. All claims verified against actual code. Slash command count locked to lockstep test EXPECTED_COMMAND_COUNT = 64.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Two related changes shipped together as docs-only:
1. Avatar swap
Replaced
archon-avatar.pngwith the new pixel-art variant (1024×1024 RGB, 456K). README line 4 image reference unchanged.2. Full README content audit + cleanup pass
Cold-read audit of all 2300 lines against actual source code at v0.1.13. Every claim verified against
src/cli_args.rs,src/command/registry.rs::default_registry(),crates/archon-tools/src/*.rs,crates/archon-core/src/agents/loader.rs,crates/archon-pipeline/src/coding/agents.rs, and the running v0.1.13 binary.Removed (claims that didn't match code):
archon kb ingest/query/compile/stats— subcommand doesn't existarchon leann index/search/stats— subcommand doesn't existarchon --list-sessions— flag is--sessions, not--list-sessionsarchon logout— no logout subcommand--sandboxCLI flag — doesn't existwarn_threshold = 100.0config default — actual is 30.0Added (existed in code but README never documented):
/run-agent,/archon-code,/archon-research,/agent,/managed-agents,/refresh,/connect,/plugin,/reload-plugins,/files,/search,/summary,/extra-usage,/providers,/cancel,/voice,/exit,/skills,/session,/hooks,/mcp,/denials,/tag,/rules,/memory,/export,/teleport)--add-dir,--bg-name,--allow-dangerously-skip-permissions,--init-only,--disable-slash-commands,--no-resume,--identity-spoof,--remote-url,--branch,--dir,--stats,--metrics-port, etc.)Lockstep test reference: the slash command count is now pinned at
EXPECTED_COMMAND_COUNT = 64persrc/command/registry.rs::tests::primaries_with_descriptions_count_matches_expected.Test plan
0.1.13 (a4570d5)against--versionarchon --list-themes(23 themes)archon --list-output-styles(5 styles)archon kbandarchon leannreturn "unrecognized subcommand"archon --list-sessionsreturns "unexpected argument" error with hint to--sessions