Agent skill
repo-structure-allowed-at-repo-root
Sub-skill of repo-structure: Allowed at Repo Root (+2).
Install this agent skill to your Project
npx add-skill https://github.com/vamseeachanta/workspace-hub/tree/main/.claude/skills/_archive/workspace-hub/repo-structure/allowed-at-repo-root
SKILL.md
Allowed at Repo Root (+2)
Allowed at Repo Root
src/ tests/ docs/ config/
scripts/ data/ specs/ reports/
pyproject.toml pytest.ini README.md CHANGELOG.md
CLAUDE.md AGENTS.md Makefile LICENSE
.gitignore .claude/ .codex/ .gemini/
.github/ .pre-commit-config.yaml
NOT Allowed at Repo Root
| Item | Correct Location |
|---|---|
Loose .py scripts |
scripts/ or src/<pkg>/tools/ |
agents/ directory |
.claude/agents/ only |
.agent-os/ |
DELETE — superseded by .claude/skills/ |
.hive-mind/, .swarm/ |
DELETE — gitignored |
business/ docs |
docs/business/ |
modules/ |
Move into src/<package>/modules/ |
bin/ (empty) |
DELETE |
_coding_agents/ |
DELETE |
examples/ |
docs/examples/ or leave at root only if README documents it |
setup.py (when pyproject.toml exists) |
DELETE — pyproject.toml supersedes it |
archive/, backups/ |
_archive/ (single, underscore-prefixed) |
*.xlsx, *.csv output files |
results/<domain>/ and gitignored |
test_export*.json |
tests/<domain>/fixtures/ or gitignored |
COVERAGE_ANALYSIS.txt |
gitignored (session artifact) |
verdict.txt, test_output_ss |
gitignored (session artifacts) |
coverage.wrk*.xml |
gitignored (session artifacts) |
Windows path dirs (D:\...) |
DELETE — filesystem artifact, never track |
Root-Level src/ Must Contain Only the Package
src/ ← OK
package_name/ ← OK (the installed package)
modules/ ← WRONG — orphaned, not installed
validators/ ← WRONG — orphaned, not installed
other_stuff/ ← WRONG
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
vamseeachanta/workspace-hub
gsd-complete-milestone
Archive completed milestone and prepare for next version
vamseeachanta/workspace-hub
gsd-reapply-patches
Reapply local modifications after a GSD update
vamseeachanta/workspace-hub
gsd-verify-work
Validate built features through conversational UAT
vamseeachanta/workspace-hub
gsd-thread
Manage persistent context threads for cross-session work
vamseeachanta/workspace-hub
clinical-trial-protocol
Generate clinical trial protocols for medical devices or drugs through a modular, waypoint-based architecture with research-only and full protocol modes.
vamseeachanta/workspace-hub
single-cell-rna-qc
Performs quality control on single-cell RNA-seq data (.h5ad or .h5 files) using scverse best practices with MAD-based filtering and comprehensive visualizations.
Didn't find tool you were looking for?