<!--
IndexTitle: GitHub Workflow
IndexDescription: Website page draft explaining GitHub as the source of truth.
IndexType: Content
IndexStatus: Draft
LastEdited: 2026-05-30
-->

# GitHub Workflow

Use GitHub as the source of truth for the work.

GitHub is the source of truth for Get Established On The Web.

The public-friendly name is Get Established Workspace: an AI-ready folder of organized files for building an online presence. The technical name is Get Established Repository when GitHub, file history, source files, and agent instructions matter.

It holds the planning, content, prompts, decisions, and future website files in one place. For beginners, think of the repository as the project folder in GitHub, with history attached. That makes the work easier to review, share, continue, and improve.

## Why GitHub Matters

- It keeps project history visible.
- It makes changes reviewable.
- It gives artificial intelligence (AI) agents a stable workspace.
- It separates source content from future generated output.
- It helps users learn a practical web workflow.
- It supports a prepared foundation that can grow without choosing a publishing platform too early.

## Basic Workflow

1. Pull the latest version of the repository.
2. Read the instructions and relevant planning files.
3. Make a small change.
4. Review the changed files.
5. Commit with a clear message.
6. Push or sync at a meaningful milestone.

Pull means bring the latest GitHub version to your local machine. Commit means save a clear checkpoint in the project history. Push or sync means send local checkpoints back to GitHub.

The goal is not to push after every tiny edit. The goal is to keep local work reviewable, then sync when a focused task or useful checkpoint is complete. This is the local-first workflow: work locally, review the change, and sync at milestones.

## What Belongs In The Repository

- Planning documents.
- Website source content, meaning plain page drafts before a website build exists.
- Reusable prompts.
- Setup notes.
- Open questions and review notes.
- Small automation when it saves repeated effort.
- Future website source files when the build approach is chosen.

The Get Established On The Web public website, the Get Established Workspace / Repository, and future user one-page business website outputs should stay distinct. GitHub helps keep those tracks organized.

## What Should Wait

- Large generated output.
- Framework scaffolds without a clear reason.
- Deployment setup before the website approach is chosen.
- Automation that is harder to understand than the task it replaces.

## Link Intent

- Link beginner setup context to `../../../Docs/Setup/UserSetupGuide.md`.
- Link GitHub workflow notes to `../../../Docs/Setup/GitHubWorkflow.md`.
- Link reusable repository pattern guidance to `../../../Docs/Setup/TemplateGuidance.md`.
- Link artificial intelligence workflow context to `AIWorkflow.md`.
- Link permission and sandbox context to `AgentPermissions.md`.

## Draft Status

This page should later link to a beginner-friendly GitHub guide once the repository has a fuller pull, edit, review, commit, and milestone sync workflow. Do not add tool-specific setup steps until the project is ready for them.
