simpe-spec

Pre-scan Markdown files before reading. Use `sspec tool mdtoc` to get file size + heading structure with line numbers (L<n> format) before reading long docs, SKILLs, or spec-docs. Eliminates blind reads.

Assess scale, create change, fill spec.md + design.md, align with user. Use after clarify when ready to define the solution.

Execute tasks from tasks.md. Implement code changes, update progress. Use after plan approval.

Break design into concrete tasks. Fill tasks.md with file-level execution plan. Use after design alignment.

User acceptance and feedback loop. Handle argue-improve cycles until user is satisfied.

Build shared understanding through dialogue and investigation. Produces Problem Statement + direction sketch. Reusable posture, not rigid phase.

Structured, efficient agent-user synchronization at decision points. Formalized exchange over prose.

Create and maintain spec-docs — knowledge that code alone cannot adequately convey.

Automate README updates and i18n translations. Use when project features change and documentation needs sync.

编写优化 Agents.md 时需要遵循的规范、风格、指南