Skip to main content
You need access to a Second Flow workspace and permission to install the GitHub App on the repositories you want to connect. Workspace owners manage repository configuration.

​
1. Open your workspace

Sign in to the Second Flow console and select the workspace you want to use. If you do not have beta access, contact us.

​
2. Connect GitHub

Open the version-control connections area and connect GitHub. Complete the GitHub App installation and grant access to the repositories you want to use. Return to Second Flow and review the accessible repositories. If a repository is missing, check the App installation’s repository access in GitHub.

​
3. Review the repository policy

Open the repository’s settings and review its understanding policy. Choose the maximum question count and whether the repository uses passing standards. Decide whether an unmet policy should produce a failed GitHub check. If you want GitHub to enforce a merge requirement, configure the relevant GitHub repository rule as well.

​
4. Select relevant context

In Context Gateway, select repository Markdown that explains architecture, conventions, or important behavior. Keep the selection focused on material that helps authors explain a change.

​
5. Open a meaningful pull request

Open a pull request that changes code behavior in the connected repository. When the change is eligible, Second Flow posts a link to its understanding check. Some changes, including documentation-only or trivial changes, do not need a check.

​
6. Complete the check

Follow the link and sign in with your Second Flow console account. Read each question and its available source context, enter your responses, then select Complete check to submit your explanation. Review the result and feedback. Second Flow returns the repository check outcome to GitHub; your workspace can also use the result as an ownership signal.