repo-structure-allowed-at-repo-root
Sub-skill of repo-structure: Allowed at Repo Root (+2).
Best use case
repo-structure-allowed-at-repo-root is best used when you need a repeatable AI agent workflow instead of a one-off prompt.
Sub-skill of repo-structure: Allowed at Repo Root (+2).
Teams using repo-structure-allowed-at-repo-root should expect a more consistent output, faster repeated execution, less prompt rewriting.
When to use this skill
- You want a reusable workflow that can be run more than once with consistent structure.
When not to use this skill
- You only need a quick one-off answer and do not need a reusable workflow.
- You cannot install or maintain the underlying files, dependencies, or repository context.
Installation
Claude Code / Cursor / Codex
Manual Installation
- Download SKILL.md from GitHub
- Place it in
.claude/skills/allowed-at-repo-root/SKILL.mdinside your project - Restart your AI agent — it will auto-discover the skill
How repo-structure-allowed-at-repo-root Compares
| Feature / Agent | repo-structure-allowed-at-repo-root | Standard Approach |
|---|---|---|
| Platform Support | Not specified | Limited / Varies |
| Context Awareness | High | Baseline |
| Installation Complexity | Unknown | N/A |
Frequently Asked Questions
What does this skill do?
Sub-skill of repo-structure: Allowed at Repo Root (+2).
Where can I find the source code?
You can find the source code on GitHub using the link provided at the top of the page.
SKILL.md Source
# 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 AGENTS.md AGENTS.md Makefile LICENSE .gitignore .Codex/ .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 | `.Codex/agents/` only | | `.agent-os/` | DELETE — superseded by `.Codex/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 ``` ---
Related Skills
interactive-report-generator
Generate interactive HTML reports with Plotly visualizations from data analysis results. Supports dashboards, charts, and professional styling.
data-validation-reporter
Generate interactive validation reports with quality scoring, missing data analysis, and type checking. Combines Pandas validation, Plotly visualization, and YAML configuration for comprehensive data quality reporting.
repo-ecosystem-hygiene
Interpret the daily read-only repo ecosystem hygiene audit and route remediation through approved workflows.
orcaflex-reporting-fixture-proof-pattern
Build and extend fixture-backed OrcaFlex reporting proof paths in digitalmodel using stable metadata baselines, normalized HTML snapshots, and reusable reporting test helpers.
repo-sync
Smart repository synchronization across workspace-hub ecosystem — diagnoses and fixes pull failures (detached HEAD, diverged branches, uncommitted changes)
repo-structure
Canonical source layout, test mirroring, root cleanliness, gitignore, docs classification, and committed artifact rules for all workspace-hub tier-1 repos. Consult before creating directories or files in any submodule.
repo-portfolio-steering
Generate a one-page portfolio steering report for workspace-hub. Use when the user invokes /repo-portfolio-steering, asks about harness vs engineering balance, wants a portfolio health check, or asks which repos to fund next. Reports on portfolio steering, GTM readiness, and provider activity balance.
repo-mission-portfolio-audit
Audit the workspace-hub repo portfolio to extract each repo's mission, identify documentation gaps, and prioritize a plan/approval sequence with explicit LLM-wiki weighting for future issue triage.
mixed-ops-vs-repo-fix-plan-boundary
Plan mixed operational-vs-repo remediation issues by proving live-state classification first, then only proposing code changes for confirmed repo-owned failure paths.
repo-separation-for-sensitive-data
Architecture pattern for splitting confidential data and reusable algorithms across repos
nested-git-repo-stash-safety
How to safely stash changes in a parent repo containing dirty nested git repositories
multi-repo-sync-diagnosis-repair
Diagnose and repair failed pulls across multi-repo ecosystems with stale locks, submodule conflicts, and untracked files