feature-loop-harness-cli 0.1.0

package/templates/default/docs/docs-map.md

@@ -0,0 +1,64 @@
+# docs-map.md
+
+하네스에서 사용하는 문서와 설정 파일의 목차다.
+
+현재 레포는 특정 제품/서비스 프로젝트를 진행하는 레포가 아니라, 실제 프로젝트 진행을 통제할 하네스 템플릿과 운영 구조를 만드는 레포다.
+
+---
+
+## Runtime
+
+- `.flh/runtime/STATE.md`: 현재 프로젝트 워크플로우 상태, 완료 상태, 승인 기록
+
+---
+
+## Workflow Config
+
+- `.flh/workflow/flow.yml`: 상태 목록, 상태별 허용 request_type, next state
+- `.flh/workflow/state-actions.yml`: 현재 상태에서 에이전트가 수행할 짧은 체크리스트와 허용 write 범위
+- `.flh/workflow/docs-spec.yml`: 문서별 완료 판정 기준
+- `.flh/workflow/transition-guards.yml`: 상태 전이별 guard 조합
+- `.flh/workflow/request-patterns.yml`: 사용자 프롬프트를 request_type으로 분류하기 위한 strong/alias 패턴
+
+---
+
+## Hook Runtime
+
+- `.codex/hooks/user-prompt-submit.sh`: Codex가 실행하는 얇은 hook wrapper
+- `.flh/hooks/user_prompt_submit.py`: 실제 `UserPromptSubmit` hook 본체
+
+---
+
+## Harness Operation Docs
+
+- `.flh/docs/PROJECT_WORKFLOW.md`: 하네스가 실제 프로젝트에 적용할 프로젝트 전체 워크플로우 설명
+- `.flh/docs/FEATURE_IMPLEMENTATION_PIPELINE.md`: `FEATURE_IMPLEMENTATION` 상태에서만 실행하는 기능 단위 구현 파이프라인
+- `docs/QUALITY_SCORE.md`: 기능별 최종 품질 점수 전역 인덱스
+- `AGENTS.md`: 에이전트가 반드시 따라야 하는 전역 안전 규칙
+
+---
+
+## Actual Project Templates
+
+다음 문서들은 하네스가 실제 프로젝트에 제공할 템플릿이다.
+현재 하네스 구현 과정에서 실제 프로젝트 내용을 채우지 않는다.
+
+- `docs/MVP.md`: 실제 프로젝트의 MVP 정의 템플릿
+- `docs/ARCHITECTURE.md`: 실제 프로젝트의 시스템 아키텍처 템플릿
+- `docs/source-layout.yml`: 아키텍처 단계에서 결정한 source directory manifest 템플릿
+- `docs/features/feature-index.md`: 실제 프로젝트의 기능 목록 템플릿
+- `docs/DB_SCHEMA.md`: 실제 프로젝트의 데이터 모델 baseline 템플릿
+- `docs/API.md`: 실제 프로젝트의 API 설계 템플릿
+- `docs/DESIGN.md`: 실제 프로젝트의 디자인 지침 산출물. 외부 파일을 가져오거나 하네스 안에서 직접 작성한다.
+
+---
+
+## Feature State Directories
+
+- `docs/features/backlog/`: 설계 대상으로 선택되었지만 아직 설계 문서가 완성되지 않은 기능
+- `docs/features/ready/`: 설계 문서 작성 완료 후 구현 대기 중인 기능
+- `docs/features/active/`: 현재 구현 중인 기능
+- `docs/features/blocked/`: 외부 의존성이나 결정 대기로 멈춘 기능
+- `docs/features/review/`: 최초 구현 초안 완료 후 사용자 검토/수정 중인 기능. 동시에 하나만 허용한다.
+- `docs/features/done/`: 사용자가 최종 완료 승인한 기능
+- `docs/features/postponed/`: 보류 또는 연기된 기능

package/templates/default/docs/features/active/.gitkeep

@@ -0,0 +1 @@
+# keep

package/templates/default/docs/features/backlog/.gitkeep

@@ -0,0 +1 @@
+

package/templates/default/docs/features/blocked/.gitkeep

@@ -0,0 +1 @@
+# keep

package/templates/default/docs/features/done/.gitkeep

@@ -0,0 +1 @@
+

package/templates/default/docs/features/feature-index.md

@@ -0,0 +1,21 @@
+---
+status: template
+---
+
+# Feature Index
+
+이 문서는 실제 프로젝트의 기능 목록과 우선순위를 관리하기 위한 템플릿이다.
+
+하네스 자체의 기능 목록을 작성하지 않는다.
+실제 프로젝트를 시작할 때 이 템플릿을 프로젝트 내용으로 채우고 `status: completed`로 변경한다.
+
+기능의 실제 진행 상태는 이 파일이 아니라 `docs/features/*/` 디렉토리 위치를 source of truth로 본다.
+
+---
+
+## Feature List
+
+| Feature ID | Name | Summary | Priority | Core Requirements | Dependencies | Reference |
+| --- | --- | --- | --- | --- | --- | --- |
+| FEAT-XXX | {{TODO_FEATURE_NAME}} | {{TODO_FEATURE_SUMMARY}} | {{TODO_PRIORITY}} | {{TODO_CORE_REQUIREMENTS}} | {{TODO_DEPENDENCIES}} | {{TODO_REFERENCE}} |
+

package/templates/default/docs/features/postponed/.gitkeep

@@ -0,0 +1 @@
+

package/templates/default/docs/features/ready/.gitkeep

@@ -0,0 +1 @@
+# keep

package/templates/default/docs/features/review/.gitkeep

@@ -0,0 +1 @@
+# keep

package/templates/default/docs/source-layout.yml

@@ -0,0 +1,33 @@
+version: 1
+status: template
+
+project:
+  type: "{{TODO_PROJECT_TYPE}}"
+  package_manager: "{{TODO_PACKAGE_MANAGER}}"
+  workspace: "{{TODO_WORKSPACE_TRUE_OR_FALSE}}"
+  runtime: "{{TODO_RUNTIME}}"
+  persistence:
+    database_required: "{{TODO_DATABASE_REQUIRED_TRUE_OR_FALSE}}"
+    database_provider: "{{TODO_DATABASE_PROVIDER_OR_NONE}}"
+  scaffold_extra_root_files: []
+
+source_roots:
+  example:
+    path: "{{TODO_SOURCE_PATH}}"
+    role: "{{TODO_ROLE}}"
+    package: "{{TODO_PACKAGE}}"
+    stack: "{{TODO_STACK}}"
+    framework: "{{TODO_FRAMEWORK_OR_NONE}}"
+    runtime: "{{TODO_PACKAGE_RUNTIME}}"
+    language: "{{TODO_LANGUAGE}}"
+    module: "{{TODO_MODULE_SYSTEM}}"
+    testing:
+      unit: "{{TODO_UNIT_TEST_TOOL}}"
+      integration: "{{TODO_INTEGRATION_TEST_TOOL_OR_NONE}}"
+      e2e: "{{TODO_E2E_TEST_TOOL_OR_NONE}}"
+      component: "{{TODO_COMPONENT_TEST_TOOL_OR_NONE}}"
+    tooling:
+      lint: "{{TODO_LINT_TOOL_OR_NONE}}"
+      format: "{{TODO_FORMAT_TOOL_OR_NONE}}"
+    scaffold: "{{TODO_SCAFFOLD_POLICY}}"
+    description: "{{TODO_DESCRIPTION}}"

package/templates/default/gitignore.template

@@ -0,0 +1,9 @@
+__pycache__/
+*.py[cod]
+.DS_Store
+*.log
+node_modules/
+.env
+.env.*
+!.env.example
+blogs.md