ref-sp-dev-repo-conventionslisted

Repo-specific conventions for this Python project (agentic-tools): the feature-first src/agentic_tools layout, pyproject.toml configuration hub, Black + Pyright-strict + pytest tooling via Poe, typing rules, CLI and script placement, and translations. Use when: creating or moving features, tests, or CLI entrypoints; deciding which top-level or package folder a file belongs in; adjusting pyproject.toml, Poe tasks, or tool config; or explaining how this repo is wired.
swiftpostlabs/agentic-tools · ★ 0 · AI & Automation · score 73

Install: claude install-skill swiftpostlabs/agentic-tools

# Repo Conventions ## Purpose Help the agent work within this repository the way it is actually structured, configured, and validated, so the codebase stays clean and maintainable. This skill owns the **repo-specific** decisions; portable guidance lives in the skills listed under Scope boundaries. ## Values - Prefer simplicity over cleverness. - Prefer maintainability over short-term convenience. - Prefer explicit structure and predictable behavior over hidden magic. ## When to use this skill - Creating, moving, or reviewing code under `src/agentic_tools/` (features, entrypoints, core plumbing). - Adding or updating tests, CLI entrypoints, or Poe tasks. - Deciding which top-level folder (`src/`, `scripts/`, `.agents/`, `.github/`) or package folder (`main`, `features`, `core`, `shared`, `infrastructure`) a file belongs in. - Adjusting `pyproject.toml`, tool configuration (Pyright, Black, pytest, Hatch), or the Poe tasks. - Explaining how this repository is wired at the top level. ## Scope boundaries This skill is the repo-specific layer. Defer portable decisions: - `.agents/skills/ref-sp-py-python/SKILL.md` — portable Python structure, typing, and CLI patterns. - `.agents/skills/ref-sp-dev-coding-patterns/SKILL.md` — language-agnostic naming, control flow, comments, testing defaults. - `.agents/skills/ref-sp-dev-projects-architecture/SKILL.md` — portable feature-folder boundaries, shared-utility thresholds, product-vs-maintenance split. Use this skill for the concre