AgentK는 소프트웨어 아키텍처 구조 설계 활동을 지원하는 에이전트 기반 시스템입니다. 이 프로젝트는 .cursor/rules/agentk/workflow.md에 명세된 구조 설계 워크플로우를 따라 체계적으로 아키텍처를 설계하고 소스 코드를 생성할 수 있도록 도와줍니다.
- 8단계 구조 설계 워크플로우: 시스템 정의부터 구조 평가까지 체계적인 설계 프로세스
- 에이전트 기반 자동화: 각 단계별로 특화된 에이전트가 작업 수행
- 자동 코드 생성: 설계된 아키텍처를 기반으로 소스 코드 자동 생성
- 문서 기반 설계: 모든 설계 결정과 구조가 문서로 명확히 기록됨
.vscode/settings.json 파일에 프로젝트 디렉토리를 설정합니다:
{
"agentk.architectureDirectory": "count/arch",
"agentk.sourceDirectory": "count/src"
}설정 항목 설명:
agentk.architectureDirectory: 구조 설계 문서가 저장될 디렉토리 (예:count/arch)agentk.sourceDirectory: 생성된 소스 코드가 저장될 디렉토리 (예:count/src)
.cursor/commands/agentk/ 디렉토리에 있는 명령어를 사용하여 구조 설계 활동을 수행합니다.
Phase 1: 시스템 정의
define-system: 시스템 정의 (system.md생성)analyze-business: 비즈니스 분석 (business.md생성)
Phase 2: 기능 명세
extract-usecases: Use Case 추출 (usecases.md생성)specify-usecase: Use Case 상세 명세 (usecase/UC-nnn.md생성)
Phase 3: 도메인 모델 정립
design-domain: 도메인 모델 설계 (domain/model.md생성)
Phase 4: 품질 요구사항 선정
elicit-scenarios: 품질 시나리오 도출 (quality/scenarios.md생성)specify-scenario: 품질 시나리오 상세 명세 (quality/QS-nnn.md생성)evaluate-scenarios: 품질 시나리오 평가 (quality/evaluations.md생성)select-scenarios: 품질 요구사항 선정 (qualities.md생성)
Phase 5: 후보 구조 설계 (candidate/candidates.md 생성)
design-performance: 성능 관련 후보 구조 설계 (candidate/QS-nnn-{title}.md생성)design-modifiability: 변경 용이성 관련 후보 구조 설계 (candidate/QS-nnn-{title}.md생성)design-msa: 마이크로서비스 아키텍처 후보 설계 (candidate/msa.md생성)design-package: 패키지/레이어 후보 구조 설계 (candidate/packages.md생성)select-solutions: 솔루션 후보 구조 설계 (candidate/solutions.md생성)select-frameworks: 프레임워크 후보 구조 설계 (candidate/frameworks.md생성)
Phase 6: 최종 구조 설계
evaluate-candidates: 후보 구조 평가 (decision/evaluations.md생성)integrate-deployment: 배치 구조 통합 (architecture/deployment.md생성)integrate-module: 모듈 구조 통합 (architecture/module.md생성)
Phase 7: 구조 명세
specify-architecture: 최종 구조 명세 (architecture.md생성)
Phase 8: 구조 평가
analyze-architecture: 구조적 의사결정 식별 (evaluation/decisions.md생성)evaluate-architecture: 구조 평가 (evaluation/evaluation.md생성)
Phase 9: 코드 생성
assign-worker: 소스 코드 구조 및 AGENTS.md 생성generate-code: 소스 코드 생성
구조 설계 활동의 전체 워크플로우는 .cursor/rules/agentk/workflow.md에 상세히 명세되어 있습니다.
- Phase 1: 시스템 정의 - 시스템과 비즈니스 드라이버 정의
/agentk/define-system 서비스에서 발생하는 count를 통합 관리하는 시스템을 개발하는 과제를 정의해줘. /agentk/analyze-business 핵심 비즈니스 드라이버를 식별해줘. - Phase 2: 기능 명세 - Use Case 추출 및 상세 명세
/agentk/extract-usecases 중요한 Use Case를 식별해줘. /agentk/specify-usecase UC-001의 상세 명세를 작성해줘. - Phase 3: 도메인 모델 정립 - 도메인 컴포넌트 식별 및 통합
/agentk/design-domain Use Case를 분석해서 도메인 모델을 정립해줘. - Phase 4: 품질 요구사항 선정 - 품질 시나리오 도출, 평가, 선정
/agentk/elicit-scenarios 품질 시나리오를 생성해줘. /agentk/specify-scenario QS-001의 상세 명세를 작성해줘. /agentk/evaluate-scenarios 품질 시나리오를 평가해줘. /agentk/select-scenarios 품질 요구사항을 선정해줘. - Phase 5: 후보 구조 설계[동작 측면] - 채택 가능한 후보 구조 설계
/agentk/design-msa msa 관점에서 후보 구조를 설계해줘. /agentk/design-performance QS-001을 분석하고 후보 구조를 설계해줘. /agentk/select-solutions 후보 구조를 분석하고 채택 가능한 솔루션 후보 구조를 설계해줘. - Phase 6: 최종 구조 설계[동작 측면] - 후보 평가 및 최종 구조 통합
/agentk/evaluate-candidates 동작 측면의 후보 구조를 평가하고 채택 여부를 결정해줘 /agentk/integrate-deployment 채택된 후보 구조를 근거로 동작 측면의 최종 구조를 설계해줘 - Phase 5: 후보 구조 설계[개발 측면] - 채택 가능한 후보 구조 설계
/agentk/design-packages 패키지/레이어 구성에 관한 후보 구조를 설계해줘. /agentk/design-modifiability QS-008을 분석하고 후보 구조를 설계해줘. /agentk/select-frameworks 후보 구조를 분석하고 개발을 위한 프레임워크 후보 구조를 설계해줘. - Phase 6: 최종 구조 설계[개발 측면] - 후보 평가 및 최종 구조 통합
/agentk/evaluate-candidates 개발 측면의 후보 구조를 평가하고 채택 여부를 결정해줘 /agentk/integrate-module 채택된 후보 구조를 근거로 개발 측면의 최종 구조를 설계해줘 - Phase 7: 구조 명세 - 최종 구조 종합 문서 작성
/agentk/specify-architecture 설계된 구조의 통합 명세서를 작성해줘. - Phase 8: 구조 평가 - 최종 구조의 품질 요구사항 만족도 평가
/agentk/analyze-architecture 명세된 구조를 분석하고 구조적 의사결정을 식별해줘. /agentk/evaluate-architecture 명세된 구조를 평가해줘. - Phase 9: 코드 생성 - 설계된 구조를 기반으로 소스 코드 생성
/agentk/assign-worker 설계된 구조를 기반으로 소스 구조와 AGENTS.md 파일을 생성해줘. /agentk/generate-code 설계된 구조를 기반으로 코드를 생성해줘.
- 구조 설계 워크플로우 - 전체 워크플로우 상세 명세
이 프로젝트는 Apache License 2.0 하에 배포됩니다. 자세한 내용은 LICENSE 파일을 참조하세요.