Development

The Development tab bridges the gap between project requirements and code. Connect your GitHub repositories, review pull requests with AI-powered analysis, and track which PRs implement which parts of your definition and specs.

Requirements-to-code traceability: Connect a GitHub repo, let Darcy review your PRs, then compute citations to see exactly which sections of your definition and specs have been implemented — and which haven't.

GitHub Connection

Before you can use PR Reviews, you need to connect a GitHub account and select repositories.

Connecting GitHub

1

Open Development Settings On the Development tab, click Connect GitHub (or the settings gear icon if you're reconfiguring). This opens the GitHub connection dialog.

2

Authenticate with GitHub Click Connect & Discover to open a GitHub OAuth popup. Sign in and authorize the DarcyIQ GitHub App. After authorization, the dialog detects your GitHub App installations.

3

Select an Installation If you have multiple GitHub App installations (e.g., personal account and organization), choose the one that contains the repositories you want to connect.

If you don't see the installation you need, click New Installation to install the GitHub App on another account or organization. The dialog will detect the new installation automatically after you complete the setup.

Alternatively, use the Manual Setup option and enter an installation ID directly.

4

Select Repositories A list of available repositories from the selected installation appears. Check the repositories you want to link to this project. Each repository shows its name and default branch.

5

Configure Author Filter (Optional) Toggle on the author filter to limit which PR authors are included in reviews. For each selected repository, a collaborator list is loaded from GitHub. Check the authors whose PRs should be reviewed — unchecked authors' PRs are excluded from review.

6

Save Click Save to store the connection. The Development tab will begin showing PR reviews for the selected repositories.

Managing the Connection

Action	Description
Change repositories	Open the settings dialog and update your repository selection
Update author filter	Toggle the filter on or off, and add or remove authors per repository
Disconnect	Click Disconnect in the settings dialog to remove the GitHub connection entirely (with confirmation)
View configuration	A summary in the dialog shows who configured the connection and when

---

PR Reviews

Once GitHub is connected, the PR Reviews sub-tab shows a list of pull requests from your linked repositories, along with Darcy's automated review analysis.

PR Review List

The PR list includes:

• Search — filter PRs by title or number

• Pagination — navigate through pages of PRs

• Status chips for each PR:

Chip	Meaning
Merged	The PR was merged into the default branch
Closed	The PR was closed without merging
Review posted	Darcy has completed its automated review of this PR
Quality score	A numeric score assessing the PR's quality
Helpful	The team rated Darcy's review as helpful (thumbs up)
Cited	This PR appears in definition or spec citations

PR Detail Panel

Click any PR to open a detail panel showing:

• Full PR information — title, number, repository, author, branches, merge status, dates

• Darcy's review — the AI-generated analysis in Markdown, including code review comments and suggestions

• Direct link — open the PR on GitHub

• Feedback — rate Darcy's review with thumbs up or thumbs down; feedback history is visible below

Providing Feedback

Feedback helps improve Darcy's review quality over time:

1. Open a PR detail panel

2. Click thumbs up if the review was helpful, or thumbs down if it wasn't

3. Your vote and a timestamp are recorded and visible in the feedback history

---

PR Citations

Citations create semantic links between pull requests and sections of your project definition and specs.

Computing Citations

1. Click the Compute Citations button on the PR Reviews sub-tab

2. Darcy analyzes all reviewed PRs and maps them to relevant headings in your definition and specs

3. Citation badges appear next to PR entries in the list (showing "Cited") and next to headings in the Definition tab

Recomputing Citations

If your definition or specs change after citations are computed, they become stale. A banner appears prompting you to recompute. Click Recompute to refresh all citations based on the current content.

Using Citations

• On the Development tab: PRs with citations show a "Cited" badge, making it easy to see which PRs implement requirements

• On the Definition tab: Section headings show citation badges linking to the specific PRs that address them

• Click any citation badge to open the referenced PR in the detail panel

---

Best Practices

Practice	Recommendation
Connect GitHub early	Set up the GitHub connection when creating the project so PR reviews begin accumulating
Use author filters	Filter out bot accounts and external contributors to focus reviews on your team's PRs
Recompute citations after sprints	After merging a batch of PRs, recompute citations to update traceability between specs and code
Provide feedback on reviews	Rate Darcy's PR reviews with thumbs up/down to improve review quality over time
Keep specs up to date	Accurate specs lead to better citation results and more useful traceability

Pro Tip: After connecting GitHub, enable the author filter to include only your delivery team members. This keeps the PR review list focused on relevant PRs and avoids noise from dependency bots or unrelated contributors.