c24165b8bc
에이전트 8종(대화형/프로그래머 C·S/디자이너/설계자/기획자/QA/PD/PM)에게 [공통 기본 능력 + 롤별 Specialty] 2층으로 지식을 주입하기 위한 재분류. 문서 내용·포맷은 무수정, 폴더 이동만 (6,372개 문서 수 보존 확인). - Topic_Programming → Domain_Programming (내부 구조 보존) - Topic_Graphic → Domain_Design - Topic_Business → Domain_Product - Topic_General → Domain_General - _Common 신설: Math(구 Topic_Math_Specialty), Reasoning(구 General/From_Thinking & Reasoning), Reasoning_Creativity(구 General/From_창의성), Communication(Poetic_Blog_Writing + From_writing) - 타 도메인의 From_* 폴더는 유지 (출처 표기일 뿐, 이미 도메인에 맞게 분류된 문서) - 빈 폴더 정리 (memory/procedures) - 에이전트→폴더 매핑은 workspace의 .astra/agent-knowledge-map.json (9개 에이전트) Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
4.3 KiB
4.3 KiB
id, title, category, status, canonical_id, aliases, duplicate_of, source_trust_level, confidence_score, verification_status, tags, raw_sources, last_reinforced, github_commit, tech_stack
| id | title | category | status | canonical_id | aliases | duplicate_of | source_trust_level | confidence_score | verification_status | tags | raw_sources | last_reinforced | github_commit | tech_stack | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| wiki-2026-0508-semgrep-assistant | Semgrep Assistant | 10_Wiki/Topics | verified | self |
|
none | A | 0.9 | applied |
|
2026-05-10 | pending |
|
Semgrep Assistant
매 한 줄
"매 SAST + LLM 의 결합 — false positive triage, custom rule 자동 생성, autofix". 매 Semgrep (pattern-based static analysis) 위에 LLM layer 를 얹어 매 noise 를 줄이고 매 fix PR 을 제안. 매 2026: Claude Opus 4.7 backend, MCP integration 으로 IDE / CI 양쪽 지원.
매 핵심
매 Semgrep 기초
- Pattern matching on AST. 매
pattern: $X == null && $X.foo()같은 syntactic rule. - 30+ language. 매 community + paid Pro rules.
- 매 fast (<1 min for typical repo), 매 deterministic.
매 Assistant 가 추가하는 것
- Triage: 매 finding 에 대해 LLM 이 "true positive 확률" + reasoning. 매 noise -60~80%.
- Autofix: 매 secure replacement code suggestion → PR comment.
- Custom rule generation: 매 자연어 → Semgrep YAML rule.
- Code understanding: data-flow context 추가 ("user input from line 42 reaches sink at line 87").
매 응용
- CI gate — 매 PR block on critical findings only.
- Backlog cleanup — 매 legacy finding triage.
- Custom org rule (e.g., "internal logger 만 사용") generation.
- Secret scanning + remediation.
💻 패턴
CLI scan
semgrep --config=auto .
semgrep --config=p/owasp-top-ten --sarif --output=results.sarif .
Custom rule
# rules/no-eval.yml
rules:
- id: no-eval
pattern: eval(...)
message: "eval() 매 dangerous"
severity: ERROR
languages: [python]
Generate rule from natural language (Assistant API)
import requests
r = requests.post(
"https://semgrep.dev/api/v1/assistant/rules",
headers={"Authorization": f"Bearer {SEMGREP_TOKEN}"},
json={"description": "Detect hardcoded JWT signing keys in Go"},
)
print(r.json()["rule_yaml"])
CI integration (GitHub Actions)
- uses: semgrep/semgrep-action@v1
with:
config: p/ci
auditOn: push
env:
SEMGREP_APP_TOKEN: ${{ secrets.SEMGREP_APP_TOKEN }}
SEMGREP_ASSISTANT: "1" # enable AI triage
Pre-commit
# .pre-commit-config.yaml
- repo: https://github.com/returntocorp/semgrep
rev: v1.95.0
hooks:
- id: semgrep
args: ['--config=p/python', '--error']
MCP server (IDE)
// claude desktop config
{
"mcpServers": {
"semgrep": {
"command": "uvx",
"args": ["semgrep-mcp"],
"env": {"SEMGREP_APP_TOKEN": "..."}
}
}
}
Programmatic triage
from semgrep_python import scan
findings = scan(target=".", config="p/security-audit")
for f in findings:
if f.assistant_triage.likelihood == "true_positive":
create_jira_issue(f)
매 결정 기준
| 상황 | Approach |
|---|---|
| Open source repo, free SAST | semgrep CLI + community rules |
| Org with high noise SAST | Semgrep Pro + Assistant |
| Want fix PR auto | Assistant autofix |
| Highly custom domain rules | Assistant rule generation |
| CodeQL already in place | 보완 (different engine) |
기본값: semgrep --config=p/ci in CI + Assistant for triage.
🔗 Graph
- 부모: Static-Analysis · Application-Security
- 변형: CodeQL · SonarQube · Snyk-Code
- Adjacent: Claude-Code · MCP
🤖 LLM 활용
언제: SAST noise 가 높아 triage backlog 누적. 매 custom rule 작성 진입장벽 낮추기. 언제 X: 매 license-sensitive (Pro tier 비용). 매 zero-network env (assistant 는 cloud).
❌ 안티패턴
- Trust autofix blindly: 매 review 필수. LLM 가 logic 바꿀 수 있음.
- Disable rule by Assistant verdict alone: false negative 위험. 매 sample audit.
- Replace human review: 매 augment, not replace.
🧪 검증 / 중복
- Verified (semgrep.dev docs, Semgrep blog 2024-2026).
- 신뢰도 A.
🕓 Changelog
| 날짜 | 변경 |
|---|---|
| 2026-05-08 | Phase 1 |
| 2026-05-10 | Manual cleanup — Assistant features + MCP 2026 |