AI 기반 초고속 개발 환경의 Context Fragment 문제 해결을 위한 Markdown 기반 상태 추적 프레임워크 설계

Context

AI 코딩 어시스턴트 도입으로 구현 속도는 비약적으로 상승했으나, 병목 지점이 코드 작성이 아닌 프로젝트 상태 관리 및 의존성 파악으로 이동함. Jira, Linear 등 팀 협업 도구는 높은 Context Switching 비용과 과도한 Friction으로 인해 1인 개발자의 다중 병렬 프로젝트 관리 요구사항을 충족하지 못하는 한계 노출.

Technical Solution

• Editor 내에서 즉시 수정 가능한 Plain Text 기반 Markdown Convention 도입을 통한 관리 Friction 최소화
• plans/, active/, shipped/, superseded/의 3단 디렉토리 구조 설계를 통한 프로젝트 생애주기 기반 상태 격리
• Frontmatter에 status, priority, depends_on, blocks 등 7개 메타데이터 필드를 정의하여 정형 데이터 추출 구조 확보
• depends_on 및 blocks 필드를 활용한 기능 간 Dependency Graph 구축으로 병목 지점의 시각적 파악 가능
• plans.json으로 변환된 데이터를 기반으로 별도 서버 없이 동작하는 Static HTML Dashboard를 구현하여 Stakeholder 공유 효율성 증대
• 예측 가능한 구조의 Markdown 형식을 채택하여 AI Coding Assistants가 별도 플러그인 없이도 프로젝트 컨텍스트를 즉시 이해하는 Native Readability 확보