필요한 사항을 기술하기

새 작업은 사용자가 포털에서 작업 내용을 기술하는 곳입니다. 결과물을 한 번만 기술하면 됩니다. Coroid는 모든 항목이 생성되기 전에 요청을 검토한 뒤 작업, 단계별 계획, 보고서 또는 자동화로 전환합니다.

작업은 이슈 트래커, 자체 시스템 및 자동화를 통해서도 유입됩니다. 다음을 참조하세요작업 시작 방법.

다음으로 생성#

첫 번째 행에서는 요청이 어떤 형태로 변환될지 결정합니다:

자동기본적으로 자동이 선택됩니다. Coroid는 요청을 자격 검증하는 동안 내용을 분석하여 가장 적합한 경로를 선택합니다. 이미 결과를 알고 있는 경우 직접 경로를 지정할 수 있습니다:작업작업 내용이 단일 변경 사항이며 리뷰어가 한 번에 읽을 수 있는 경우,계획특정 순서에 따라 여러 변경 사항이 필요하거나, 어떤 작업을 진행하기 전에 전체 접근 방식을 확인하고 싶을 때 사용합니다.

사용자가 경로를 선택했지만 자격 검증 단계에서 다른 경로가 권장되는 경우, 생성 전에 양식에 해당 내용이 안내됩니다. 권장 사항을 수락하거나 요청 내용을 수정할 수 있습니다.

두 개 이상의 프로젝트에 걸치는 작업은 항상 계획으로 처리됩니다. 두 번째 프로젝트가 추가되면자동및계획만 사용할 수 있습니다.

양식은 경로에 맞게 조정됩니다. 보고서는 아래에 별도의 세부 정보를 요청하며, 작업과 계획에는 사양 섹션이 표시됩니다. 자동화 기능에도 고유한 양식이 있어 실행 시기와 수행 작업을 지정할 수 있습니다. 자세히 보려면자동화.

양식 옆에는 두 개의 바로가기 버튼이 있습니다:이슈 가져오기는 트래커에서 작업을 가져옵니다. 그리고Coroid에게 문의하기는 동일한 작업을채팅 도우미.

프로젝트#

이 작업이 속할 프로젝트를 선택하세요.자동및계획당신은더 많은 프로젝트를 추가할 수 있습니다작업이 여러 관련 프로젝트에 걸칠 경우에 해당합니다. 이렇게 하면 교차 프로젝트 작업이 표현됩니다. 하나의 작업은 정확히 하나의 프로젝트에서 실행됩니다.

작업 내용을 설명하세요#

두 개의 필드이며 각각 다른 역할을 합니다.

작업 제목: 짧은 이름입니다. 나중에 목록에서 이를 기준으로 검색하게 됩니다.

요약: 실질적인 내용입니다. 결과물, 맥락, 제약 조건, 원본 자료 및 Coroid가 제공해야 할 사항을 포함합니다. 구현 방법이 아닌 결과물을 작성하세요; Coroid가 이를테스트 가능한 명세그리고 완성된 작업을 이러한 약속과 비교하여 확인합니다.

Add rate limiting to the public API.
100 requests per minute per API key. Exceeding it returns 429 with a
Retry-After header. Limits are per key, not per IP.
Internal service-to-service calls are exempt — they authenticate with
service tokens, not API keys.
Do not change the existing auth middleware's public interface.

마지막 줄이 실제 작업을 수행합니다. 범위 정의 라인은 집중된 변경과 광범위한 변경을 구분하는 기준이 됩니다.

에 대해자동화, 작업및계획요약 아래에 파일을 드롭하거나 붙여넣거나 첨부할 수 있습니다: 스크린샷, PDF 및 메모 등입니다. 작업에는 이미지를 사용할 수 있으며, 계획에는 PDF와 텍스트 파일도 사용할 수 있습니다.

명세#

작업과 계획에는명세섹션에 두 가지 옵션이 있습니다:

• 요약에서 가져오기: 기본 설정입니다. Coroid는 요약(의도, 사용자 스토리 및 수용 기준)을 바탕으로 명세를 작성한 뒤 그에 맞춰 작업을 구축하고 검증합니다.
• 직접 작성: 생성된 명세를 직접 작성한 내용으로 대체합니다. 의도, 사용자 스토리, 수용 기준, 제약 조건, 비즈니스 가치, 범위 및 유형을 직접 입력하세요.

와 함께직접 작성, AI로 구조 구성요약의 필드를 초안으로 작성하여 거기서부터 편집할 수 있습니다. 또한 보존된 내용, 추가된 내용, 포함되지 못한 내용에 대한 목록을 표시하므로 요약의 내용이 누락되지 않았는지 확인할 수 있습니다.

수용 기준이 이미 존재하는 경우, 예를 들어 제품 요구사항에 있는 경우에는 직접 작성하세요. 그렇지 않으면 요약에서 시작하여 작업의 명세 탭에서 결과를 수정하세요.명세 기반 개발.

고급 설정#

선택 사항입니다. 표시되는 필드는 경로에 따라 달라집니다.

SDLC 워크플로우 사용#

기본적으로 비활성화되어 있습니다. 이를 활성화하면의도및명세계획 수립이 시작되기 전에 최종 버튼이 다음과 같이 변경됩니다:작업 준비그리고 즉시 작업을 생성하는 대신 안내형 준비 절차가 열립니다.

접근 방안이 초안으로 작성되기 전에 점검 단계를 거치고 싶을 만큼 중요한 작업인 경우 이 기능을 활성화하세요. 요구사항이 이미 명확한 작업의 경우에는 비활성화해도 됩니다. 다음 항목을 참조하세요:SDLC 워크플로우.

작업 시작 전 검증#

기본적으로 활성화되어 있습니다. 조직 정책에서 허용하는 경우 요청에 대해 검증 기능을 비활성화할 수 있습니다. 이 경우 사유를 입력해야 하며, 수행자, 사유, 시간 및 정책 정보는 감사 추적 기록에 영구적으로 저장됩니다. 검증 단계가 건너뛰어진 경우 고급 설정 제목에 해당 내용이 표시됩니다.

목표#

계획에만 적용됩니다. 계획이 달성해야 할 목표는 무엇인가요?_그 이상의 내용_요구사항에 포함된 내용입니다. 요구사항은 무엇을 구축할지 명시하고, 목표는 그 구축물의 용도를 설명합니다.

AI 프로필#

이 작업을 처리하는 데 사용되는 모델은 무엇인가요? 다음 항목을 참조하세요:AI 프로필.

품질 관리 검사#

적용될 검증 수준은 무엇인가요?정책 기본값 사용프로젝트 또는 조직의 품질 관리 정책을 상속받습니다.표준현재 검사 절차를 실행합니다.철저한요구사항을 바탕으로 더욱 세심한 실시간 검사를 추가하여 표준 수준에서는 통과되는 작업도 거부할 수 있습니다.

결정된 정책은실행이 시작될 때 확정됩니다. 이후에 정책을 변경해도 이미 진행 중인 작업에는 소급 적용되지 않습니다. 다음 항목을 참조하세요:품질 정책 및 게이트.

우선순위#

P0에서P3까지 설정하며, 기본값은P2입니다. 대기 중인 작업량이 에이전트 슬롯 수보다 많을 때 우선순위에 따라 대기열 순서가 결정됩니다. 이 기능은 처리 용량을 늘려주지는 않으니 다음 항목을 참조하세요:처리 용량 및 에이전트 슬롯.

토큰 예산#

계획의 경우,생성된 작업당 토큰 예산각 생성된 작업이 사용할 수 있는 컨텍스트 양을 제한합니다. 작업의 경우,최대 토큰 예산작업 자체의 토큰 사용량을 제한합니다. 제한을 두지 않으려면 이 필드를 비워두세요. 대규모 코드베이스를 광범위하게 읽어야 하는 작업의 경우 예산을 높이고, 일상적인 작업에서는 비용을 절감하기 위해 예산을 낮추세요.

제약 조건#

계획에만 적용됩니다. 계획의 제약 조건, 비목표 항목, 종속 관계 및 배포 규칙을 설정할 수 있습니다. 여기에 명시적인 비목표 항목을 기재하며, 범위 확장을 방지하는 데 가장 효과적인 필드입니다.

시작 지점 / 풀 요청 대상#

pull request가 타겟으로 하는 분기와 작업이 시작되는 분기를 지정합니다.시작 지점과 동일기본적으로 선택되어 있어 두 항목이 동일한 설정을 따릅니다.

main → new Coroid branch → PR into main

Coroid는 항상 작업 분기를 생성합니다. 이 필드들은 단지 분기 지점과 pull request가 적용될 위치를 변경할 뿐입니다. Coroid가 기존 분기에 직접 커밋하도록 설정할 수 없으며, 계속 진행하기 전에 양식에서 원격 저장소에 해당 분기들이 존재하는지 확인합니다.

기본 분기가 아닌 다른 분기, 예를 들어develop분기나 릴리스 트레인에 병합할 때 이 옵션을 사용하세요.

스프린트 및 대상 릴리스#

작업 및자동요청이 작업으로 전환됩니다. 해당 작업을스프린트에 배치하고 계획된릴리스에 처음부터 연결하여 나중에 할당하는 번거로움을 줄일 수 있습니다.

계속: 자격 검증#

“계속”을 누르면 아무것도 생성되지 않습니다.계속. Coroid는 먼저 요청 내의 인증 정보 및 기타 민감한 값을 필터링한 뒤자격 검증:

자격 검증은 요청을 현재 릴리스와 비교하여 중복 여부를 확인하고, 가능한 부분은 검증 또는 재현하며, 영향도, 소유권, 범위, 난이도를 평가한 뒤 처리 방향을 결정합니다. 각 검증 단계를 실시간으로 확인할 수 있습니다.

그 이후의 진행 과정은 검증 결과에 따라 달라집니다:

• 자격 충족: 자격 검증을 통과하면 첨부 파일이 없는 작업이나 계획, 그리고 SDLC 워크플로우가 즉시 생성됩니다. 그렇지 않으면 양식으로 돌아가게 되며리뷰 후 생성라고 표시되며, 최종 버튼에는 생성될 항목의 이름이 표시됩니다: 작업 생성, 계획 생성, 보고서 생성또는자동화 생성. 새 작업은 즉시 대기열에 추가되고 새로운 계획의 수립이 시작됩니다.
• 중복또는이미 수정됨: 새 작업은 생성되지 않습니다. 중복된 요청은 이미 해당 내용을 포함하는 요청에 병합됩니다.
• 이미 해결됨: 동일한 문제나 오류가 이미 다른 프로젝트의 다른 요청에서 처리 중입니다. 해당 요청은 그 작업과 연동됩니다.
• 변경 필요 없음: 평가 결과 보고된 현상이 의도된 동작임이 확인되었습니다. 작업은 생성되지 않습니다.
• 연기됨: 작업 접수 API 또는 모니터링 등을 통해 사람이 지정되지 않은 요청에만 적용됩니다. 해당 작업은 요건을 충족하지만 대기해야 합니다. 명령의용량이나 예산 부족으로 인해 대기하는 경우입니다. 여기서 생성하는 요청은 절대 연기되지 않습니다.
• 재현 불가, 거절됨또는검토 필요: 작업은 생성되지 않습니다. 요청을 수정하여 증거를 추가하거나, 자격 검증을 다시 시도하거나, 요청을 종료하세요.

결정 내용에 동의하지 않는 경우, 권한이 있는 사용자는어쨌든 작업 생성. 재정의 시에는 사유를 기입해야 하며, 해당 사유는 반드시 기록됩니다.

결정 대기 중인 요청은Factory → 리뷰에 나열되며, 모든 제출물은 결정 결과와 관계없이 점검 내역, 증거 및 감사 추적 정보를 포함한 별도의 페이지를 유지합니다.

관련 항목#

• 작업 시작 방법
• 명세 기반 개발
• 계획
• 작업 가져오기