Project Architecture, Clean Code & Documentation Skill

Repository structure baseline

.
├── .agents/skills/       # project-scoped agent skills (this convention)
├── .github/workflows/    # CI
├── src/                  # or app/ + components/ etc. per framework skill
├── public/
├── docs/                 # architecture decision records, longer docs
├── .env.example          # documented, never real secrets
├── README.md
└── package.json