This directory is the structured knowledge base for maintaining comfyui_o1key. Keep executable rules concise in AGENTS.md; keep explanations, diagrams, and procedures here.

Start here

Architecture: runtime boundaries, startup flow, storage, and dependency direction.
Development: how to add or change nodes, clients, routes, and frontend extensions.
Testing: isolated offline suite, smoke tests, and validation matrix.
Configuration: supported settings, storage, precedence, and security rules.
Architecture decisions: durable decisions and the ADR template.
Maintenance history: the deep-cleanup baseline for the current layout.

Knowledge ownership

Change	Required documentation
User installation or visible behavior	`README.md`
Runtime boundary or data flow	`docs/architecture.md`
Configuration key or precedence	`docs/configuration.md`
Development/test procedure	`docs/development.md` or `docs/testing.md`
Compatibility-sensitive design choice	`docs/decisions/NNNN-title.md`
One-time repository maintenance	`docs/maintenance/YYYY-MM-DD-topic.md`

AI handoff checklist

Before ending a non-trivial change, leave the repository in a state where the next maintainer or agent can answer:

What runtime boundary changed?
Which invariant protects backward compatibility?
Which offline test proves the behavior?
Which document is now the source of truth?
Are any follow-up risks or decisions still open?