docs: add DeepWiki entry point and Pages-ready product guide

[seonghobae]

Outcome

Improve the aFIPC public surface without changing calibration behavior.

• add the canonical Ask DeepWiki badge with exact repository casing;
• replace the README opening with concise product-facing responsibility for fixed-item IRT linking/equating;
• add docs/index.md with product scope, core workflow, architecture, onboarding, release/change-control guidance, and documentation entry points;
• preserve existing maintenance and numerical-compatibility guidance below the public-facing overview.

Public-surface follow-up

The repository currently has homepage=null and has_pages=false. This PR provides the owned docs/index.md prerequisite only; Pages should not be claimed live until the organization metadata reconciler enables the intended source and HTTPS publication is re-read successfully.

The current repository description is already broadly accurate but can be normalized centrally to a concise customer-facing form such as “Automated fixed-item parameter calibration for IRT linking and equating.” Existing useful psychometrics/IRT/C++ topics should be preserved while central ecosystem/lifecycle topics are reconciled declaratively.

Concurrency

No open PR currently owns README or docs/index.md; active aFIPC writers are focused on R implementation/security/performance changes. This branch is based on protected master@f87c2324f1686135e57d8730c1b0b9420874f300 and touches documentation only.

---

Summary by CodeRabbit

• 문서
  • README에 DeepWiki 배지와 저장소 설명을 추가하고, 문서·운영·개발 상태 안내를 간결하게 정리했습니다.
  • 저장소 구성, 알고리즘 호환성, GitHub Actions 및 Dependabot 운영 정책을 명시했습니다.
  • aFIPC의 목적, 워크플로, 패키지 구조, 온보딩, 릴리스 및 변경 관리 정책을 새 문서로 추가했습니다.

[coderabbitai]

Caution

Review failed

The pull request is closed.

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Team

Run ID: 8a9ead63-9a09-4543-8785-96ecfc23ace0

📥 Commits

Reviewing files that changed from the base of the PR and between f87c232 and 066150a.

📒 Files selected for processing (2)

• README.md
• docs/index.md

---

📝 Walkthrough

Walkthrough

README.md를 갱신하고 docs/index.md를 추가했습니다. 문서는 aFIPC의 목적, 저장소 구조, 호환성, 운영 가드레일, 개발 절차 및 지원 리소스를 설명합니다.

Changes

저장소 문서 갱신

Layer / File(s)	Summary
저장소 개요 및 운영 정책 README.md	DeepWiki 배지와 aFIPC 설명을 추가했습니다. 저장소 구성, 알고리즘 호환성, GitHub Actions 및 Dependabot 운영 가드레일을 갱신했습니다. autoFIPC() 유지보수 정책 문장을 정리했습니다.
프로젝트 전체 문서 docs/index.md	aFIPC의 책임, 핵심 처리 단계, R 패키지 구조, 검사 명령, 온보딩, 릴리스 정책, 관련 문서 및 지원 리소스를 추가했습니다.

Estimated code review effort: 1 (Trivial) | ~5 minutes

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch docs/public-surface-deepwiki-pages

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}

[seonghobae]

Closing this duplicate public-surface lane after a full writer re-check found that #261 already owns the canonical README/docs surface, including the exact-cased Ask DeepWiki badge and a Pages-ready docs/index.md. The repository-facing work should remain consolidated in #261 rather than creating a competing README/docs writer. I also removed the stale area: ci-cd classification from #261 because it changes documentation/ADRs only and no CI workflow.

[devin-ai-integration]

Devin Review found 1 potential issue.

[devin-ai-integration]

🟡 Markdown lint blocks the pull request

The new prose exceeds the configured line limit, so markdownlint-cli2 reports 11 violations. The required Code Quality check fails.

Prompt for agents

Wrap the new prose in README.md and docs/index.md to the configured 80-character Markdown line limit. Run the repository's exact markdownlint-cli2 0.18.1 command from .github/workflows/code-quality.yml and ensure all 11 introduced MD013 violations are cleared.

---

Was this helpful? React with 👍 or 👎 to provide feedback.

[seonghobae]

Addressed on current branch after the public-surface and licensing expansion: README.md and docs/index.md prose are wrapped to the repository's 80-character Markdown line-length contract. The only intentionally long lines are URL/code forms that markdownlint treats under its configured exceptions. Exact-head checks must regenerate on the new head; predecessor review/check evidence is not reused.