inspector:form

Form state and validation runtime debugging

항목	내용
Invoke	/inspector:form
Category	kobic-development
Complexity	simple
MCP Servers	flutter-inspector

/inspector:form — 입력 폼이 안 될 때 들여다보는 도구#

한마디로#

회원가입·로그인 같은 입력 화면이 왜 안 넘어가는지 그 자리에서 열어보는 진단 도구입니다. 서류가 반려됐을 때, 어느 칸을 잘못 썼는지 빨간 줄을 찾아주는 검토 담당자라고 생각하면 됩니다.

누가·언제 쓰나요#

실행 중인 Flutter 앱에서 입력 폼이 제출되지 않을 때
입력값 검증(이메일 형식, 필수 항목 등)이 이상하게 동작할 때
각 입력 칸이 지금 어떤 상태인지(올바른지, 비었는지) 확인하고 싶을 때

무엇을 해주나요#

화면에 있는 폼 목록과 각 폼의 입력 칸 개수·유효 여부를 보여줍니다
특정 폼의 상세 상태(칸별 입력값, 통과/실패, 오류 메시지)를 알려줍니다
폼의 모든 오류를 한 번에 모아 보여줍니다
검증을 수동으로 한 번 돌려서 어디가 걸리는지 확인합니다

어떻게 쓰나요#

# 화면의 폼 목록 보기
/inspector/form list

# 특정 폼(loginForm)의 상세 상태 보기
/inspector/form state loginForm

# 폼의 오류 모아보기
/inspector/form errors

# 폼 검증을 수동으로 실행
/inspector/form validate loginForm

loginForm 자리에는 확인하려는 폼의 이름(키)을 넣으면 됩니다. 어떤 폼이 있는지 모르면 먼저 list로 목록을 확인하세요.

안에서 무슨 일이 벌어지나요#

증상별로 정해진 점검 순서를 따라갑니다.

제출이 안 될 때: 폼의 현재 상태를 확인하고, 유효하지 않으면 오류를 모아본 뒤 검증 로직을 점검합니다.
검증이 안 먹힐 때: 검증을 수동으로 돌려보고 오류 메시지와 검증 함수 로직을 살펴봅니다.
입력값이 자꾸 사라질 때: 칸별 입력값을 확인하고 입력 컨트롤러 연결과 상태 복원 로직을 점검합니다.
오류 메시지가 안 보일 때: 오류가 실제로 있는지 확인하고, 오류 표시 위젯과 자동 검증 설정을 점검합니다.

⚙️ 상세 옵션·실행 명세 (개발자 / AI 에이전트용)

Triggers#

Form submission failure
Validation issues
Field state check

MCP Tools#

form_list#

Lists all forms on the current screen.

Response example:

{
   " forms " : [
    {
       " key " :  " loginForm " ,
       " fieldCount " : 3,
       " isValid " : false,
       " fields " : [ " email " ,  " password " ,  " rememberMe " ]
    }
  ]
}

form_get_state#

Returns the detailed state of a specific form.

Parameters:

formKey: Form key (required)

Response example:

{
   " formKey " :  " loginForm " ,
   " state " : {
     " isValid " : false,
     " fields " : {
       " email " : {
         " value " :  " user@example " ,
         " isValid " : false,
         " error " :  " Invalid email format " 
       },
       " password " : {
         " value " :  " *** " ,
         " isValid " : true,
         " error " : null
      }
    }
  }
}

form_get_errors#

Returns all errors for a form.

form_validate#

Manually validates a form.

Common Diagnostics#

Form not submitting#

1. form_get_state - >   Check current state
2. If isValid: false, check errors
3. form_get_errors - >   Query all errors
4. Review validation logic

Validation not working#

1. form_validate - >   Run manual validation
2. Check error messages
3. Review validator function logic

Field values not persisting#

1. form_get_state - >   Check field values
2. Verify TextEditingController connection
3. Review form state restoration logic

Error messages not showing#

1. form_get_errors - >   Confirm errors exist
2. Check ErrorText widget rendering
3. Check AutovalidateMode settings

Examples#

Check form list#

/inspector/form list

Check form state#

/inspector/form state loginForm

Check form errors#

/inspector/form errors

Manual validation#

/inspector/form validate loginForm

References#

Detailed implementation: .claude/agents/flutter-inspector-form.md
Master inspector: .claude/commands/inspector.md
UI inspector: .claude/commands/inspector/ui.md