메뉴
Use when adding a command to this project's own CLI (the app CLI under app/cli/, not the aegis tool). Covers the command module, Typer registration, the sync-plus-asyncio.run rule, and i18n strings.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
Use when cutting a release of the aegis-stack package. Covers the version-bump file set, the changelog cut, the three release gates, TestPyPI rc verification, and the tag-push mechanics that trigger the publish workflow.
Use when adding a new HTTP endpoint to this project's FastAPI backend. Covers the router module, request and response schemas, dependency wiring, router registration, the health surface, and the API test.
Use when adding or changing a database model in this project. Covers the SQLModel table definition, the alembic autogenerate migration flow, and the query rules that keep access performant.
Use when adding a job that runs on a schedule (periodic or at a fixed time) in this project. Covers writing the task function and registering it with the scheduler.
Use when adding or removing a capability (a component or service) in this project, or pulling framework updates. Covers the aegis add, remove, and update commands and what each one changes.
Use when an API endpoint in this project must require an authenticated user or a specific role. Covers the auth dependencies, attaching them to a route, and the session and cookie rules.
| name | add-cli-command |
| description | Use when adding a command to this project's own CLI (the app CLI under app/cli/, not the aegis tool). Covers the command module, Typer registration, the sync-plus-asyncio.run rule, and i18n strings. |
The project ships a Typer CLI under app/cli/. A command module exposes a Typer
app that is mounted in the CLI root, so a command is not runnable until it is
both defined and registered.
Use when adding a subcommand to this project's CLI.
Do NOT use for HTTP routes (see the add-api-endpoint skill) or for background
or scheduled work.
app/cli/: command modules live here; add <name>.py exposing a Typer app.app/cli/main.py: register the command by mounting its Typer app.app/i18n/locales/en.py: add any user-facing strings as i18n keys (English
only; other locales are a separate translation pass).tests/cli/, invoking the command with a
Typer runner. Confirm it fails for the right reason.app/cli/ with a Typer app and the command
functions.def: Typer has no native async support, so call async
code with asyncio.run(...) from inside the sync command.app/cli/main.py (mount its Typer app under a name).app/i18n/locales/en.py.make check: lint, typecheck, and test.app/cli/main.py never appears in the
CLI; registration is what wires it in.async def does not work: Typer runs it as a coroutine it
never awaits, so keep the command sync and use asyncio.run(...) for async
calls.en.py instead.