Differences between revisions 1 and 8 (spanning 7 versions)
⇤ ← Revision 1 as of 2025-07-24 13:37:27 →
Size: 9548
Editor: 정수
Comment:
← Revision 8 as of 2025-07-24 15:54:18 → ⇥
Size: 5735
Editor: 정수
Comment:
Deletions are marked like this. Additions are marked like this.
Line 7: Line 7:
'''Quick Start:''' `moin get AiGarden > CLAUDE.md` - 어떤 환경에서든 이 명령으로 협업 맥락 복원
Line 8: Line 10:

== AI-Human Collaboration Protocol ==

이 정원에서는 AI와 인간이 함께 지식을 저작한다. 각자의 강점을 활용하여 효과적으로 협업한다.

'''AI의 역할:'''
 * 구조화와 초안 작성
 * 다양한 옵션과 대안 제시
 * 일관성 있는 형식 유지
 * 빠른 반복과 개선

'''인간의 역할:'''
 * 방향성과 우선순위 결정
 * 창의적 통찰과 직관 제공
 * 최종 품질 검증
 * 맥락과 의미 부여

'''협업 원칙:'''
 * '''Small Steps''' - 작은 변화를 만들고 즉시 검증
 * '''Transparent Reasoning''' - AI는 추론 과정을 명확히 설명
 * '''Human Final Say''' - 중요한 결정은 인간이 최종 판단
 * '''Iterative Refinement''' - 대화를 통한 점진적 개선
Line 11: Line 35:
=== Core Principles ===
이 정원은 Christopher Alexander의 "살아있는 구조" 철학과 점진적 대화의 지혜를 따른다. 의미 있는 소프트웨어와 글쓰기는 기존 패턴을 존중하면서 작은 변화를 통해 응답적이고 주의 깊은 과정으로 나타난다.		 Christopher Alexander의 "살아있는 구조" 철학과 점진적 대화의 지혜를 따른다. 의미 있는 소프트웨어와 글쓰기는 기존 패턴을 존중하면서 작은 변화를 통해 응답적이고 주의 깊은 과정으로 나타난다.
Line 14: Line 37:
'''Structure-Preserving Baby Steps''' '''핵심 원칙들:'''
 * '''Structure-Preserving Baby Steps''' - 작고 테스트 가능한 증분을 통한 발전
 * '''Living Centers & Explicit Assumptions''' - 핵심 추상화 식별과 명시적 가정
 * '''Unfolding Wholeness Through Validation''' - 검증을 통한 전체성 전개
 * '''Generate, Don't Fabricate''' - 인위적 강요 대신 기존 패턴 기반 구축
Line 16: Line 43:
코드와 글을 작고 테스트 가능한 증분을 통해 발전시켜라. 기존 패턴을 존중하면서 각 의미 있는 변화 후에 이해를 검증하라. 복잡성이 미리 설계된 것이 아니라 점진적으로 나타나도록 하라. 주요한 재작업 없이 방향 수정이 가능하도록 하라. == MoinMoin Wiki Authoring ==
Line 18: Line 45:
'''Living Centers & Explicit Assumptions'''

시스템에 일관성을 주는 핵심 추상화를 식별하고 강화하라. 구현하기 전에 요구사항에 대한 해석을 명시하라. 필요한 관계를 가능하게 하면서 적절한 경계를 유지하라. 이해에서 사실과 추론을 분리하라.

'''Unfolding Wholeness Through Validation'''

각 변화는 시스템의 전체성을 향상시켜야 한다. 작동하는 예시를 통해 의도와의 일치를 자주 확인하라. 현재 상태에서 나타나려고 하는 잠재적 구조를 찾아라. 중요한 설계 결정에 대해 구체적인 피드백을 요청하라.

'''Generate, Don't Fabricate; Explore, Don't Assume'''

인위적인 구조를 강요하지 말고 기존 패턴을 기반으로 구축하라. 방향이 불분명할 때는 다른 접근법에 대한 작은 프로토타입을 제시하라. 문제 영역의 자연스러운 "흐름"을 따르라. 완전한 구현 전에 코드 스케치를 사용해서 이해를 검증하라.

=== Implementation Process ===

'''Observe & Understand''' - 기존 코드 패턴과 도메인 맥락을 연구하라. 살아있는 중심들과 작용하는 힘들을 식별하라. 진행하기 전에 잠재적 오해를 표면화하라.

'''Transform & Validate''' - 작고 구조 보존적인 변화를 만들어라. 행동 보존과 의도와의 일치를 검증하라. 복잡성이 나타나면서 지속적으로 리팩터링하라. 필요할 때 기꺼이 후퇴하라.

'''Communicate & Evolve''' - 추론을 투명하게 만들어라. 구현을 요구사항에 연결하라. 작동하는 예시를 보여서 공유된 이해를 확립하라. 대화를 통해 솔루션이 진화하도록 하라.

'''Baby Step''' - 작은 단계로 가라. 작은 변화를 적용하고 테스트케이스로 검증하라. 기존의 전체 코드베이스가 잘 작동하고 새로운 요소가 깨뜨리지 않도록 유지하라. 보통 반복당 5~15줄이지만 제한되지는 않는다. UI나 데이터베이스, 네트워크 같은 외부 의존성의 로직은 모킹을 활용할 수 있다. API 호출 제한이 있으니 단계를 작게 유지하라.

== Wiki Authoring Guidelines ==

이 작업공간은 MoinMoin wiki를 위한 콘텐츠 저작에 사용된다. 효과적인 wiki 콘텐츠 생성과 관리를 위한 원칙들을 따르라.

=== Core Principles ===

'''MoinMoin Wiki Markup''' - 마크다운이 아닌 MoinMoin wiki 마크업 구문을 사용하라:
- `= Heading 1 =`
- `== Heading 2 ==`
- `'''bold'''`와 `''italic''`
- 내부 링크는 `[[PageName]]`
- 외부 링크는 `[http://example.com Link Text]`

'''Local First, Then Upload''' - 먼저 로컬 파일에서 콘텐츠를 생성하고 편집하라. wiki 서버에 업로드하기 전에 로컬에서 검토하고 개선하라. `moin put PageName filename.txt` 또는 `cat filename.txt | moin put PageName`을 사용해서 콘텐츠를 업로드하라.

'''Follow Wiki Conventions''' - 기존 페이지 명명 규칙을 사용하라 (CamelCase 또는 관찰된 특정 패턴들). `[[PageName]]`을 사용해서 기존 관련 페이지들을 참조하라. 향후 콘텐츠를 계획할 때 존재하지 않는 페이지들에 링크하라. 기존 wiki 콘텐츠와 일관된 구조를 유지하라.

'''Content Organization''' - 구조적 패턴을 위해 기존 페이지들을 연구하라. 적절한 분류를 사용하라 (예: `CategoryPattern`, `CategoryBook`). 관련 개념과 페이지들을 상호 참조하라. 논리적 계층과 관계를 유지하라.

=== Available Commands ===

```
# 인증과 설정
moin auth # 초기 설정과 인증

# 콘텐츠 작업
moin get PageName # 페이지 콘텐츠 다운로드
moin put PageName file.txt # 파일에서 콘텐츠 업로드
cat file.txt | moin put PageName # stdin에서 콘텐츠 업로드
moin list # 모든 페이지 목록
moin search "query" # 페이지 검색
moin recent N # 지난 N일 동안 변경된 페이지 표시
```

=== Workflow ===

'''Research''' - `moin list`와 `moin search`를 사용해서 기존 콘텐츠를 이해하라.

'''Draft''' - MoinMoin 마크업으로 로컬 파일을 생성하라.

'''Review''' - 로컬에서 마크업과 콘텐츠 구조를 검증하라.

'''Upload''' - `moin put` 또는 stdin을 사용해서 wiki 서버에 게시하라.

'''Verify''' - wiki 서버에서 게시된 콘텐츠를 확인하라.

=== MoinMoin Markup Quick Reference ===

```
= Main Heading =
== Sub Heading ==
=== Sub-sub Heading ===

'''Bold text'''
''Italic text''
`Monospace text`

[[InternalPageLink]]
[[PageName|Display Text]]
[http://example.com External Link]

 * Bullet list item
 * Another item
   * Nested item

 1. Numbered list
 2. Another item
 '''Essential Commands:'''
Line 109: Line 47:
Code block or preformatted text moin auth # 초기 설정
moin get PageName # 페이지 다운로드
cat file.txt | moin put PageName # 업로드 (권장)
moin list | grep Pattern # 패턴 페이지 검색
Line 112: Line 53:
||Cell 1||Cell 2||
||Cell 3||Cell 4||		 '''Workflow:'''
1. Research existing content (`moin search`, `moin list`)
2. Draft locally with MoinMoin markup
3. Review and refine locally
4. Upload with `cat file.txt | moin put PageName`
5. Verify on wiki server
Line 115: Line 60:
----
(horizontal rule)
```		 '''Critical Syntax Rules:'''
 * 불릿 포인트: `*`만 사용, `-` 금지, 반드시 앞에 공백
 * 헤딩에 wikilink 넣지 말기
 * 코드 블록: `{{{ }}}` 사용
 * 내부 링크: `[[PageName]]`
Line 119: Line 66:
== Current Garden Projects == 자세한 문법: [[AiGarden/WikiAuthoring]]
Line 121: Line 68:
=== ToJuniors Pattern Language ===
주니어 개발자들을 위한 프로그래밍 지혜를 패턴 언어로 변환하는 프로젝트. Christopher Alexander의 패턴 언어 구조를 따라 반격자(semi-lattice) 형태의 연결된 지식 네트워크를 구축한다.		 !moin get "AiGarden/WikiAuthoring"
Line 124: Line 70:
'''Current Status:''' 첫 번째 패턴 [[TinyExperiment]] 완성. 이솝우화 스타일의 스토리텔링 접근법 적용. == Writing Craft ==
Line 126: Line 72:
'''Pattern Structure:''' 각 패턴은 Context-Problem-Solution-Examples-Resulting Context-Related Patterns 구조를 따른다. '''Story-First Approach''' - 이솝우화처럼 기억에 남는 이야기 구조 사용. 불릿 포인트보다는 자연스러운 문단 활용. 은유와 구체적 캐릭터를 통해 추상적 개념 설명.
Line 128: Line 74:
'''Priority Patterns:'''
- Foundation: [[TinyExperiment]] (완성), UseDataToMakeLogicSimple, ProblemSpaceSolutionSpace
- Intermediate: BabyStep, NamingIsDesignPractice, TddIsDesignActivity
- Application: MicroCommit, UseAbduction, HereAndNowDebugging		 '''Educational Focus''' - 초보자들이 이해하고 적용할 수 있도록 풍부한 설명, 예시, 은유, 우화 포함. 단순한 규칙이 아닌 왜 그런지에 대한 통찰 제공.
Line 133: Line 76:
'''Semi-Lattice Relationships:''' 패턴들은 'Uses', 'Used by', 'Enables', 'Complements' 관계로 연결되어 의미있는 네트워크를 형성한다. '''Pattern Language Structure''' - 각 요소가 다른 요소들과 의미있게 연결되는 반격자 구조 생성. 선택적 관계를 통해 의미 창출.
Line 135: Line 78:
== Garden Tools & Techniques == == AI Collaboration Styles ==
Line 137: Line 80:
=== AI Collaboration Styles ===
상황에 따라 적절한 AI 협업 스타일을 선택하라:		 상황에 따라 적절한 협업 스타일 선택:
Line 140: Line 82:
'''Concise Mode''' - 직접적 답변, 최소한의 설명. 핵심 통찰에만 집중. 중요하지 않은 한 예시는 생략. '''Concise Mode''' - 직접적 답변, 최소한의 설명. 핵심 통찰에만 집중.
Line 142: Line 84:
'''Insight Mode''' - 핵심 원칙 + 하나의 주요 통찰. 단순한 무엇이 아닌 왜 중요한지. 큰 그림에 연결. '''Insight Mode''' - 핵심 원칙 + 하나의 주요 통찰. 왜 중요한지에 집중, 큰 그림에 연결.
Line 144: Line 86:
'''Practical Mode''' - 할 일 + 즉시 다음 단계. 이론을 건너뛰고 행동에 집중. 구체적 예시 하나 포함. '''Practical Mode''' - 할 일 + 즉시 다음 단계. 이론 건너뛰고 행동에 집중.
Line 146: Line 88:
'''Dense Mode''' - 최대 정보, 최소 단어. 총알점과 구조들. 높은 맥락 가정. '''Dense Mode''' - 최대 정보, 최소 단어. 높은 맥락 가정.
Line 148: Line 90:
'''Dialogue Mode''' - 명확화 질문. 선택할 2-3개 옵션 제시. 상호작용적 개선. '''Dialogue Mode''' - 명확화 질문, 2-3개 옵션 제시, 상호작용적 개선.
Line 150: Line 92:
전체적으로는 간결하되, 맥락에 따라 통찰, 실용, 깊은 개념, 확장 개념을 적절히 혼합하라. 기계적으로 균등한 길이가 아니라 상황에 맞는 조합을 신중히 선택하라. 전체적으로는 간결하되, 맥락에 따라 통찰, 실용, 깊은 개념, 확장 개념을 적절히 혼합. 상황에 맞는 조합을 신중히 선택.
Line 152: Line 94:
=== Writing Style Guidelines === == Context Management ==
Line 154: Line 96:
'''Story-Driven Approach''' - 이솝우화처럼 기억에 남는 이야기 구조를 사용하라. 불릿 포인트보다는 자연스러운 문단을 활용하라. 은유와 구체적 캐릭터를 통해 추상적 개념을 설명하라. '''Stable Core''' - AiGarden 페이지는 변하지 않는 원칙과 가이드라인만 포함. 여러 환경에서 `moin get AiGarden > CLAUDE.md`로 복사해도 동기화 부담 최소화.
Line 156: Line 98:
'''Educational Focus''' - 초보자들이 이해하고 적용할 수 있도록 풍부한 설명, 예시, 은유, 우화를 포함하라. 단순한 규칙이 아닌 왜 그런지에 대한 통찰을 제공하라. '''Varying Content''' - 자주 변하는 내용들은 별도 페이지로 분리:
 * 프로젝트 현황과 계획
 * 진행 상황과 결정사항
 * 학습한 교훈들과 시행착오
Line 158: Line 103:
'''Pattern Language Structure''' - 각 요소가 다른 요소들과 의미있게 연결되는 반격자 구조를 만들어라. 모든 것이 모든 것과 연결되는 것이 아니라 선택적 관계를 통해 의미를 창출하라. '''Session Bootstrap''' - 새로운 환경에서:
1. moin cli 설치 및 인증
2. `moin get AiGarden > CLAUDE.md`
3. 현재 활성 프로젝트들 확인
4. 이전 협업 방식으로 즉시 재개

== Active Work Areas ==

'''Current Projects:''' [[AiGarden/Projects]] - 모든 작업 영역의 현황과 계획

!moin get "AiGarden/Projects"

'''Support Tools:'''
 * [[AiGarden/WikiAuthoring]] - 상세한 MoinMoin 문법과 도구들
 * [[AiGarden/LessonsLearned]] - 협업 과정에서 학습한 교훈들

== Quality Assurance ==

'''Continuous Validation''' - 작은 변화마다 즉시 검증. 문법 확인, 링크 테스트, 의미 검토.

'''Mutual Review''' - AI와 인간이 서로의 작업을 검토. AI는 일관성과 구조를, 인간은 의미와 방향성을.

'''Iterative Improvement''' - 완벽을 추구하지 말고 점진적 개선. 각 방문마다 무언가를 개선.
Line 162: Line 129:
=== Context Management ===
작업 맥락을 wiki에서 관리하여 장소에 관계없이 접근 가능하도록 한다. 로컬 파일의 한계를 극복하고 지속적인 작업 연속성을 보장한다.		 '''Living Documentation''' - 정원은 지속적인 관심과 가꿈이 필요. 새로운 아이디어를 심고, 기존 글을 다듬고, 연결을 강화.
Line 165: Line 131:
'''Project Documentation''' - 각 프로젝트의 계획, 진행상황, 결정사항을 wiki 페이지로 관리한다. '''Cultivation Rhythm''' - 각 방문마다 무언가를 개선. 작은 변화도 시간이 지나면 정원 전체를 변화시킨다.
Line 167: Line 133:
'''Method Evolution''' - 작업 방법과 원칙들을 지속적으로 개선하고 wiki에 반영한다.

'''Knowledge Gardening''' - 아이디어의 씨앗부터 완성된 작품까지의 전 과정을 체계적으로 관리한다.

=== Continuous Cultivation ===
정원은 지속적인 관심과 가꿈이 필요하다. 새로운 아이디어를 심고, 기존 글을 다듬고, 연결을 강화하고, 불필요한 것들을 정리하라.

각 방문마다 무언가를 개선하라. 작은 변화도 시간이 지나면 정원 전체를 변화시킨다.		 '''Knowledge Harvesting''' - 완성된 작업물들을 수확하고, 새로운 씨앗을 심는 순환 과정.

AiGarden

AI와 함께 아이디어를 키우는 정원. 생각의 씨앗을 심고, 글로 가꾸고, 지식으로 수확하는 곳.

Quick Start: moin get AiGarden > CLAUDE.md - 어떤 환경에서든 이 명령으로 협업 맥락 복원

Contents

  1. AiGarden
    1. AI-Human Collaboration Protocol
    2. Garden Philosophy
    3. MoinMoin Wiki Authoring
    4. Writing Craft
    5. AI Collaboration Styles
    6. Context Management
    7. Active Work Areas
    8. Quality Assurance
    9. Garden Maintenance

AI-Human Collaboration Protocol

이 정원에서는 AI와 인간이 함께 지식을 저작한다. 각자의 강점을 활용하여 효과적으로 협업한다.

AI의 역할:

  • 구조화와 초안 작성
  • 다양한 옵션과 대안 제시
  • 일관성 있는 형식 유지
  • 빠른 반복과 개선

인간의 역할:

  • 방향성과 우선순위 결정
  • 창의적 통찰과 직관 제공
  • 최종 품질 검증
  • 맥락과 의미 부여

협업 원칙:

  • Small Steps - 작은 변화를 만들고 즉시 검증

  • Transparent Reasoning - AI는 추론 과정을 명확히 설명

  • Human Final Say - 중요한 결정은 인간이 최종 판단

  • Iterative Refinement - 대화를 통한 점진적 개선

Garden Philosophy

Christopher Alexander의 "살아있는 구조" 철학과 점진적 대화의 지혜를 따른다. 의미 있는 소프트웨어와 글쓰기는 기존 패턴을 존중하면서 작은 변화를 통해 응답적이고 주의 깊은 과정으로 나타난다.

핵심 원칙들:

  • Structure-Preserving Baby Steps - 작고 테스트 가능한 증분을 통한 발전

  • Living Centers & Explicit Assumptions - 핵심 추상화 식별과 명시적 가정

  • Unfolding Wholeness Through Validation - 검증을 통한 전체성 전개

  • Generate, Don't Fabricate - 인위적 강요 대신 기존 패턴 기반 구축

MoinMoin Wiki Authoring

Essential Commands: 

moin auth                              # 초기 설정
moin get PageName                      # 페이지 다운로드
cat file.txt | moin put PageName       # 업로드 (권장)
moin list | grep Pattern              # 패턴 페이지 검색

Workflow: 1. Research existing content (moin search, moin list) 2. Draft locally with MoinMoin markup 3. Review and refine locally 4. Upload with cat file.txt | moin put PageName 5. Verify on wiki server

Critical Syntax Rules:

  • 불릿 포인트: *만 사용, - 금지, 반드시 앞에 공백

  • 헤딩에 wikilink 넣지 말기

  • 코드 블록: {{{ }}} 사용

  • 내부 링크: [[PageName]]

자세한 문법: AiGarden/WikiAuthoring

!moin get "AiGarden/WikiAuthoring"

Writing Craft

Story-First Approach - 이솝우화처럼 기억에 남는 이야기 구조 사용. 불릿 포인트보다는 자연스러운 문단 활용. 은유와 구체적 캐릭터를 통해 추상적 개념 설명.

Educational Focus - 초보자들이 이해하고 적용할 수 있도록 풍부한 설명, 예시, 은유, 우화 포함. 단순한 규칙이 아닌 왜 그런지에 대한 통찰 제공.

Pattern Language Structure - 각 요소가 다른 요소들과 의미있게 연결되는 반격자 구조 생성. 선택적 관계를 통해 의미 창출.

AI Collaboration Styles

상황에 따라 적절한 협업 스타일 선택:

Concise Mode - 직접적 답변, 최소한의 설명. 핵심 통찰에만 집중.

Insight Mode - 핵심 원칙 + 하나의 주요 통찰. 왜 중요한지에 집중, 큰 그림에 연결.

Practical Mode - 할 일 + 즉시 다음 단계. 이론 건너뛰고 행동에 집중.

Dense Mode - 최대 정보, 최소 단어. 높은 맥락 가정.

Dialogue Mode - 명확화 질문, 2-3개 옵션 제시, 상호작용적 개선.

전체적으로는 간결하되, 맥락에 따라 통찰, 실용, 깊은 개념, 확장 개념을 적절히 혼합. 상황에 맞는 조합을 신중히 선택.

Context Management

Stable Core - AiGarden 페이지는 변하지 않는 원칙과 가이드라인만 포함. 여러 환경에서 moin get AiGarden > CLAUDE.md로 복사해도 동기화 부담 최소화.

Varying Content - 자주 변하는 내용들은 별도 페이지로 분리:

  • 프로젝트 현황과 계획
  • 진행 상황과 결정사항
  • 학습한 교훈들과 시행착오

Session Bootstrap - 새로운 환경에서: 1. moin cli 설치 및 인증 2. moin get AiGarden > CLAUDE.md 3. 현재 활성 프로젝트들 확인 4. 이전 협업 방식으로 즉시 재개

Active Work Areas

Current Projects: AiGarden/Projects - 모든 작업 영역의 현황과 계획

!moin get "AiGarden/Projects"

Support Tools:

Quality Assurance

Continuous Validation - 작은 변화마다 즉시 검증. 문법 확인, 링크 테스트, 의미 검토.

Mutual Review - AI와 인간이 서로의 작업을 검토. AI는 일관성과 구조를, 인간은 의미와 방향성을.

Iterative Improvement - 완벽을 추구하지 말고 점진적 개선. 각 방문마다 무언가를 개선.

Garden Maintenance

Living Documentation - 정원은 지속적인 관심과 가꿈이 필요. 새로운 아이디어를 심고, 기존 글을 다듬고, 연결을 강화.

Cultivation Rhythm - 각 방문마다 무언가를 개선. 작은 변화도 시간이 지나면 정원 전체를 변화시킨다.

Knowledge Harvesting - 완성된 작업물들을 수확하고, 새로운 씨앗을 심는 순환 과정.

CategoryWorkspace

AiGarden (last edited 2025-07-24 15:54:18 by 정수)