메뉴
Stack lens para Python. Use durante Discovery quando pyproject.toml, setup.py ou requirements.txt for detectado. Cobre FastAPI, Django, Flask, Litestar, Celery workers, data apps, packaging src/ vs flat.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
Skill que constrói o Co-change Graph - "quando arquivo X muda, qual outro arquivo geralmente muda junto?". Use durante Discovery e em /fp:cochange. Baseado em git history. Detecta arquivos co-dependentes que devem ser editados juntos para evitar PRs incompletos. v0.3.0+ usa engine nativo Rust quando disponível (10-100x mais rápido).
Skill que detecta e instala o binário nativo first-plan-engine (Rust) na primeira invocação. Use quando algum command (cochange, hash, futuramente ast/index/search) for invocado e o binário não estiver presente. Oferece download via GitHub Releases. Plugin funciona sem o engine (graceful fallback), mas com ele fica 10-100x mais rápido.
Skill que extrai inteligência do git history - heatmap de atividade, ownership, branches/PRs in-flight. Use durante Discovery e em /fp:hot, /fp:owner, /fp:in-flight. Tudo via comandos git read-only.
Skill que define como o comando /fp:plan emite um plano detalhado para uma feature. Use quando precisar gerar plano que respeite a camada compilada, verifique duplicidade contra 09-features, identifique reuse e siga template em meta-templates/plan.md. Sempre pausa pedindo aprovação ao final.
Esta skill DEVE ser carregada em qualquer comando do plugin first-plan. Define o protocolo PLAN-FIRST (Discovery -> Plan -> Approval -> Execution -> Report), as 7 regras invioláveis e o comportamento esperado em cada fase. Ative quando o usuário invocar /fp:* ou mencionar "first-plan", "context compilation", "discovery layer", "spec-code reconciliation".
Skill que define o schema de proveniência e o sistema de freshness tracking para findings em .first-plan/. Use durante Discovery e refresh para registrar source (file:line@SHA), TTL, confidence inicial e cadeia de supersedeção. Aplica decay de confidence baseado em idade.
| name | first-plan-lens-python |
| description | Stack lens para Python. Use durante Discovery quando pyproject.toml, setup.py ou requirements.txt for detectado. Cobre FastAPI, Django, Flask, Litestar, Celery workers, data apps, packaging src/ vs flat. |
| version | 0.1.0 |
| Sinal | Variante |
|---|---|
manage.py na raiz | Django |
fastapi em deps | FastAPI |
flask em deps | Flask |
litestar em deps | Litestar |
celery em deps | Worker |
streamlit em deps | Data app |
dagster, airflow, prefect | Data pipeline |
setup.py apenas | lib legacy |
pyproject.toml com [tool.poetry] | Poetry |
pyproject.toml com [tool.uv] ou uv.lock | uv |
pyproject.toml com [build-system] setuptools | setuptools moderno |
Pipfile | pipenv |
src/ vs flatrequires-python)strict = true?)asyncio diretoanyio (compatibilidade)trioconftest.py em pasta tests/ -> fixtures globaispytest.mark.integration)unittest.mock, pytest-mock, responses (HTTP)FastAPI:
app/routers/Depends()app/schemas/Django:
app/<name>/ com models.py, views.py, urls.py, admin.py<project>/settings.pytemplates/Flask:
create_app())?logging (dominante).first-plan/Padrão. Adicional:
01-topology/boundaries.md - rotas FastAPI/Django/Flask, tasks Celery02-conventions/di.md - Depends() vs constructor vs factoryAumentar:
[tool.mypy] strict = true + arquivos sem # type: ignore -> alta confiança em "tipagem estrita"pyproject.toml bem definido com tools configuradasReduzir:
super(Cls, self).__init__() ao lado de super().__init__())from x import * (smell)except: ou except Exception: sem logar nem re-raisedef f(x=[]):)assert em produção (removido com python -O)