Best practices

Use stable keys, keep APP.md declarative, split procedures into Skills, split facts into Knowledge, mark optional capabilities as optional, preserve provenance, and provide at least one example workspace. Do not hide required permissions in prose; declare them in frontmatter.

Checklist

• Keep declarations machine-readable.
• Keep procedures in Agent Skills.
• Keep facts in Agent Knowledge.
• Keep execution in the host runtime.
• Attach app provenance to projected objects.