Imported from Team-Cyan/seed-agent (AGENTS.md). Install upstream with npx skills add Team-Cyan/seed-agent. Copyright stays with the author.

AGENTS.md

Name: seed-agent
Author: Team-Cyan

This file is the repository entrypoint for coding agents.

Keep this file short. Treat it as a table of contents, not the full knowledge base.

Read Order

For most tasks, read in this order:

docs/ai/project-overview.md
docs/roadmap.md
The relevant module doc(s) under docs/ai/modules/
docs/operations/session-handoff.md only if the task depends on recent unfinished work
A matching spec or plan only when the task changes behavior, architecture, or sequencing

Do not start by reading every spec or every plan.

Keep AI-facing docs in English.
Reply to the human user in Chinese unless they ask for another language.
Prefer small, well-bounded sessions.
Work on one module or one roadmap item at a time.
Keep .agents/ thin; keep durable knowledge in docs/.
Update the most relevant module doc and docs/roadmap.md when project state materially changes.
Before commit, push, or release, check the release version policy in docs/operations/release-process.md. Code fixes and operational fixes bump patch by 0.0.1; new features bump minor by 0.1.0; docs-only changes may keep the version unchanged unless they are part of a deployment release.

Keep secrets in gitignored local files such as local/secrets/.
Keep deployment-specific capacities, account identifiers, private IPs, and host paths in config/live-*.yaml or other gitignored local runtime files.
Run python scripts/check_public_repository.py before commit or push.
Do not commit tokens, cookies, passkeys, or downloader credentials.
qBittorrent mutations must stay dry-run by default unless the user explicitly wants execution.
Cleanup actions are high risk. Do not widen delete or pause behavior casually.
Preserve the existing RSS implementation. It remains useful for fallback flows and for other sites.

M-Team currently supports RSS parsing, API-key detail enrichment, and API-driven discovery.
RSS should remain in the repo for fallback flows and other sites.
Local state in .seed-agent/state.db and audit in .seed-agent/audit.jsonl are durable project evidence, not disposable temp files.