Files

T

Antigravity Agent c24165b8bc refactor(topics): 멀티 에이전트용 지식 재편 — _Common(공통 기본기) + Domain_* 구조

에이전트 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>

2026-07-11 11:05:56 +09:00

3.5 KiB

Raw Blame History

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

title

KISS (Keep It Simple, Stupid)

매 한 줄

"매 simplest-thing-that-could-possibly-work". 매 1960s Lockheed Skunk Works 의 Kelly Johnson 의 aerospace heuristic → 매 software 매 universal 의 design principle. 매 sibling: YAGNI, Worse-is-Better, Occam's Razor.

매 핵심

매 mechanism

매 each abstraction 의 cognitive cost 의 measure.
매 minimum-viable design → 매 iterate.
매 complexity 매 emergent, never additive cheap.

매 forms

Code: fewer lines, fewer abstractions, fewer dependencies.
API: fewer endpoints, fewer params, fewer states.
System: fewer services, fewer protocols, fewer config knobs.

매 응용

Pre-mature abstraction avoidance (Rule of Three).
Boring-tech preference (PostgreSQL > custom DB).
Monolith-first (Fowler), microservices later if needed.

💻 패턴

KISS 매 too-complex (anti)

// Over-engineered: factory + builder + strategy for "add 2 numbers"
class AdderFactory {
  static create(strategy: AddStrategy): Adder { /* ... */ }
}

KISS 매 right

const add = (a: number, b: number) => a + b;

Service split: simple-first

// Simple: 1 service, postgres
app.post('/order', async (req, res) => {
  const order = await db.orders.create(req.body);
  await sendEmail(order);
  res.json(order);
});

// Only when justified by load/team-size: split into microservices.

Dependency minimalism

# package.json 매 audit — every dep is liability
npm-check --unused
depcheck

Config 매 default-driven

// Bad: 27 required env vars
// Good: smart defaults, override only when needed
const PORT = process.env.PORT ?? 3000;
const DB_URL = process.env.DATABASE_URL ?? 'postgres://localhost/dev';

Naming for clarity

// Bad
function p(d: any[]) { /* ... */ }

// Good
function paginate(items: Item[]): Page<Item> { /* ... */ }

매 결정 기준

상황	Choice
First version	Simplest possible, single file if needed
매 second feature 의 same shape	Still don't abstract
매 third 의 same shape (Rule of Three)	Now abstract

기본값: Inline the code. Abstract only when 매 third 의 same pattern emerges.

🔗 Graph

부모: Software-Design-Principles
변형: YAGNI
Adjacent: Premature-Optimization · Rule of Three

🤖 LLM 활용

언제: design review, architecture decision, code review (cut complexity). 언제 X: 매 inherent-complexity domain (compilers, crypto, distributed consensus) 매 simplification 매 wrong-target.

❌ 안티패턴

Premature abstraction: 1 use 의 abstraction 매 wrong shape.
Configuration explosion: every-flag-as-knob.
Microservices day-one: 매 distributed monolith 의 invitation.

🧪 검증 / 중복

Verified (Kelly Johnson — Lockheed Skunk Works; Rich Hickey — Simple Made Easy talk; Worse-is-Better essay).
신뢰도 A.

🕓 Changelog

날짜	변경
2026-05-08	Phase 1
2026-05-10	Manual cleanup — KISS FULL content with anti-patterns

3.5 KiB Raw Blame History