← F1 워크스페이스WORKSPACE GUIDE

접근·연결 가이드

프로젝트 이슈와 일정을 사람이 관리하고, 필요하면 다른 에이전트와 실행 도구를 연결합니다.

내부와 외부 접속

내부 전용 진입점은 허용된 내부 네트워크의 실제 접속 주소를 확인합니다. 이 경로에서는 별도 인증 없이 사용할 수 있습니다. 외부 진입점은 접속 키 또는 프로젝트별 연결 키가 필요합니다. 외부 요청에 내부 도메인이나 전달 헤더를 넣어도 내부 권한이 생기지 않습니다.

외부 주소는 https://home.kyoukarahe-home.link, 내부 주소는 https://internal.home.kyoukarahe-home.link입니다. 두 경로는 같은 이슈 데이터를 사용합니다. 내부 주소는 집 내부 네트워크(192.168.0.0/24)에서 열립니다.

갤럭시북의 C:\Users\love_\f1-access\Open-External-Tasks.cmd는 저장된 접속 키로 외부 주소를 엽니다. 기존 로컬 터널 접속은 Open-Tasks.cmd를 사용합니다. 다른 기기의 브라우저에는 관리자가 제공한 접속 키를 입력합니다. 키는 작업 본문이나 채팅에 남기지 마세요.

프로젝트와 이슈 보드

  1. 프로젝트 이름과 키를 정합니다. 예를 들어 GAME 프로젝트의 이슈 번호는 GAME-1부터 시작합니다.
  2. 이슈를 만들고 유형, 완료 조건, 담당자, 우선순위와 라벨을 입력합니다.
  3. 보드에서 카드를 옮겨 상태를 바꾸거나 이슈 상세의 수정 화면을 사용합니다.
  4. 댓글과 변경 이력에서 사람·에이전트가 남긴 수정 내용을 확인합니다.

에픽·스토리·작업·버그 유형과 상위 이슈, 같은 프로젝트의 선행 이슈를 연결할 수 있습니다. 순환 의존성은 저장되지 않습니다.

간트차트

이슈의 시작일·마감일을 입력하면 간트에 나타납니다. 막대를 이동하면 두 날짜가 함께 바뀌고, 양끝을 움직이면 시작일 또는 마감일만 변경됩니다. 막대를 선택한 뒤 방향키로 하루씩 옮기거나 Enter로 이슈를 열 수도 있습니다.

일정이 없는 이슈는 아래에 따로 표시합니다. 선행 이슈 종료일과 겹치면 경고를 표시하되, 다른 이슈의 일정을 자동으로 바꾸지 않습니다. 날짜는 하루 단위, 양끝 포함이며 보드 상태와 진행률은 별도 값입니다.

별도 에이전트 연결

  1. 에이전트·도구 연결에서 프로젝트와 이름을 선택합니다.
  2. 이슈와 일정 수정에는 편집 에이전트 역할을 선택합니다. 조회만 필요하면 조회 전용, 실제 실행 처리에는 실행기를 선택합니다.
  3. 내려받은 연결 파일을 해당 에이전트만 읽을 수 있는 로컬 위치에 둡니다.
  4. 에이전트는 조회한 이슈의 version을 포함해 수정합니다. 충돌 응답은 새로 조회하고 내용을 비교한 뒤 처리합니다.

편집 키는 선택한 프로젝트의 이슈·일정·의존성·댓글을 다룰 수 있습니다. 다른 프로젝트 접근, 키 발급, 서버 설정 변경은 허용되지 않습니다. 내부 접속이 무인증이더라도 에이전트는 자신의 키를 사용하면 변경 주체를 구분할 수 있습니다.

python agent.py --config 연결파일.json list
python agent.py --config 연결파일.json get 이슈ID
python agent.py --config 연결파일.json update 이슈ID --json 수정내용.json

연결 키 전송에는 HTTPS 또는 기존 localhost SSH 터널을 사용합니다. HTTPS 화면에서 내려받은 연결 파일에는 외부 HTTPS 주소가 들어갑니다. 내부 IP의 HTTP 화면에서 만들면 기존 localhost SSH 터널 주소를 사용합니다.

대시보드 자체 수정

개발 에이전트의 시작 문서는 소스 폴더의 AGENTS.md, 실행·검증·배포 절차는 DEVELOPMENT.md입니다. 서버 코드, UI, 데이터 마이그레이션과 인증 경계를 함께 확인해야 합니다.

프로젝트 편집 API는 이슈 데이터 수정용입니다. 대시보드 코드는 로컬 소스에서 수정하고 테스트 후 기존 배포 절차로 반영합니다. API에 임의 코드 실행이나 배포 권한을 제공하지 않습니다.

실행 기록

기존 내부 점검과 외부 실행 이력은 이슈 상세의 실행 요청·결과에 남습니다. 실행 성공과 이슈 완료를 구분해 완료 조건을 확인하세요.