doslang-mirror/AGENTS.md

doslang 작업 규칙

DOS용 시스템 프로그래밍 언어 Ferro와 그 컴파일러 fec. 규범 문서는 SPEC.md이며 이 파일은 그것을 구현할 때의 작업 규칙만 다룬다.

문서 지도

파일	역할
SPEC.md	언어 명세. 유일한 규범 문서. 구현 지시서와 표준 라이브러리 명세는 별도 문서
tools/README.md	호스트 요구사항, 최초 셋업, 자동화 구조

개발 환경과 테스트 명령 목록·플래그는 다음 CLI로 확인한다.

uv run python tests/run.py --help

검증 규칙

• 컴파일러는 현재 프런트엔드만 구현되어 있다. 범위: lexer/parser/types/own/check/resolve.
• 코드 생성기(백엔드/IR/lowering)는 아직 없다.
• 호스트 C 컴파일러는 구현/검증 대상이 아니다. 호스트는 편집, Git, 다운로드, 격리 작업공간 준비에만 쓴다.
• 완료하려는 기능을 직접 검사하는 pytest case가 통과해야 한다. 테스트가 증명하지 않는 기능은 완료로 처리하지 않는다.
• uv run python tests/run.py 는 프런트엔드 검증 엔트리이다.
• VGA 데모처럼 수동 검증이 필요한 항목은 자동 완료 게이트에서 제외한다.
• 실행 환경은 .dosboxx/와 tests/run.py로 준비되며, 과거 VM 이미지/호스트 바이너리는 완료 근거로 쓰지 않는다.

빌드 함정

• [백엔드 복귀 시 유효] 컴파일러는 16비트 large model로 빌드한다. small model은 메모리 부족으로 실패한다.
• [백엔드 복귀 시 유효] 링크는 *.obj 와일드카드로 한다. DOS 명령줄 길이 제한 때문에 오브젝트를 개별 열거할 수 없다.
• [백엔드 복귀 시 유효] M4 Watcom 테스트는 -wx -wcd=202를 쓴다. 생성 C의 보수적 미 사용 helper 때문에 W202만 끄고 나머지 경고는 오류로 유지한다.
• [백엔드 복귀 시 유효] fixture는 DOS 8.3 이름으로 실행한다. 긴 이름은 registry에서 명시적으로 줄인다.
• [백엔드 복귀 시 유효] R:은 읽기 전용 저장소, W:은 읽기 전용 Watcom이다. 빌드 산출물은 반드시 임시 C:\FEC에 쓴다.
• [백엔드 복귀 시 유효] 실패 분석이 필요하면 tests/run.py의 --keep-failed 또는 런처 플래그로 임시 작업공간을 보존한다.

작업 흐름

• 명세 판단이 바뀌면 SPEC.md를 즉시 갱신하고 SPEC.AUDIT.md에 사유를 누적한다. 구현이 명세와 다르면 둘 중 하나가 틀린 것이므로 그 자리에서 결론을 낸다.
• 검증된 마일스톤마다 커밋하고 항상 origin에 푸시한다.
• primary 브랜치는 master다.
• .dosboxx/의 다운로드, 실행 작업공간, 로그는 커밋하지 않는다.

현재 상태

현재 구현 상태와 다음 마일스톤은 SPEC.md와 테스트 registry를 기준으로 판단한다. 과거 VM 이미지나 호스트에 남은 바이너리를 근거로 완료 처리하지 않는다.