convez.ai
SkillDevOps & InfraestruturaAvançado
purewater02

Agent Config Starter

purewater02/agent-config-starter

Configuração minimalista e curada para agentes de código em produção

Ver no GitHub
InicialPluginScore · de 0 a 100

Kit de configuração production-grade para rodar agentes de IA coding em serviços reais. Fornece templates de CLAUDE.md, AGENTS.md e skills com foco em disciplina de contexto, redução de token wastage e curadoria intencional de prompts para backend e infra teams.

Instalação

$npx convez-ai purewater02/agent-config-starter

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 5 meses
Versão
—
Issues abertas
0
Contribuidores
1

Casos de uso

  • Estruturar CLAUDE.md/AGENTS.md para times backend rodarem agents em código real
  • Otimizar orçamento de tokens eliminando ruído e contexto desnecessário
  • Definir skills on-demand em vez de carregar workflows sempre ativos

Veredito

Recurso sólido para times que precisam escalar agentes de código em ambiente production. A ênfase em curadoria intencional e budgeting de tokens resolve um problema real — agentes "ruins" muitas vezes refletem contexto mal estruturado, não capacidade do modelo.

README

A tradução para o português deste README ainda está na fila.

agent-config-starter

Production-grade CLAUDE.md / AGENTS.md / skills starter for backend & infra teams. 바이브코딩 말고 실서비스 — 현업에서 AI 코딩 에이전트를 제대로 굴리기 위한 설정 스타터킷.

대부분의 "에이전트가 멍청해진다"는 모델 문제가 아니라 컨텍스트 규율(discipline) 문제입니다. 이 스타터킷은 실서비스에서 코딩 에이전트를 굴릴 때 바로 쓰는, 토큰 예산을 의식한 설정 템플릿 모음입니다.

왜 (Why)

  • 핵심은 *누가 썼느냐(사람 vs LLM)*가 아니라 큐레이션 여부입니다. 한 연구(ETH Zürich, Evaluating AGENTS.md, 2026)에 따르면 — naive하게 자동 생성해 그대로 쌓은 컨텍스트 파일은 작업 성공률을 오히려 깎았고, 사람이 의도적으로 추린 파일은 (소폭) 도움이 됐습니다. 양쪽 다 추론 비용은 늘립니다.
  • 그래서 이 킷의 목표는 "더 쓰기"가 아니라 신호만 남기고 덜어내기입니다. LLM은 생성이 아니라 압축·삭제에 쓰는 게 맞습니다 — 판단은 사람이.
  • 항상 로드되는 설정은 "항상 켜진 비용"입니다. 얇고 정확할수록 매 요청이 싸지고 또렷해집니다.

무엇이 들어있나 (What's inside)

파일역할
AGENTS.md크로스툴 표준 단일 출처 — 빌드/테스트·코드 스타일·아키텍처 경계
CLAUDE.md얇은 프로젝트 컨텍스트 (AGENTS.md를 가리킴)
skills/on-demand 스킬 예시 (워크플로는 항상 로드하지 말 것)
.claudeignore컨텍스트 위생 — 노이즈 제외
CONTEXT-BUDGET.md토큰 예산·죽은 무게 제거·Context Rot 임계 가이드

원칙 (Production discipline)

  1. CLAUDE.md는 얇게. 항상 필요한 최소만. 워크플로는 스킬로 내린다.
  2. 워크플로 = 스킬(on-demand). 필요할 때만 로드되게 한다.
  3. AGENTS.md = 단일 출처. 모순되는 규칙이 에이전트를 갈팡질팡하게 만든다.
  4. 설정은 영어로. 항상 로드되는 파일은 영어가 토큰을 2~3배 아낀다.
  5. 예산을 측정하라. /context로 시작 전 점유율을 보고, 안 쓰는 건 지운다.

빠른 시작 (Quick start)

# 1) 템플릿 복사
cp AGENTS.md CLAUDE.md .claudeignore /path/to/your/repo/

# 2) AGENTS.md를 프로젝트에 맞게 채운다 (빌드/테스트/경계)
# 3) Claude Code에서 /context 로 시작 점유율을 확인한다
# 4) 안 쓰는 스킬/섹션을 제거하고 다시 측정한다

더 보기

실서비스에서 AI 코딩 에이전트 쓰는 법을 기록합니다.

GitHub: @purewater02

License

MIT — see LICENSE.

Ver o original no GitHub

Bom para

Relacionados