23  Addendum — Collaboration, Security & Workflow Policies

23.0.1 Collaboration & WIP Sharing Norms

  • Daily visibility: For every active task, share progress every workday even if messy or incomplete.

  • Start-of-task footprint: Create a GitHub Issue and Draft PR on Day 0 (empty repo/placeholder acceptable). Push work-in-progress commits frequently.

  • Proof of work: Link your Issue/PR in daily check‑ins; summarize what changed, what’s next, and any blockers.

  • No silent stretches: If stuck or context‑switching, post a short “I’m blocked on X; trying Y; ETA for next update Z” message in the project channel.

23.0.2 GitHub Workflow Standard

  • Issue → Branch → Draft PR → Review → Merge is the default flow.

  • Branch naming: issue-<short-slug> (e.g., issue-feather-dash-loader).

  • No direct pushes to main/prod.

  • PR hygiene: Make the message concise, do not just use AI to generate extensive content that the reviewer must read. If possible use a PR template (scope, screenshots, test notes, risks). Mark as a draft. Ask for reviews if guidance is required. When ready and CI tests have passed convert to ready for review and slack the reviewer.

  • Review SLA: 16 business hours for first review; pair if blocked > 24 hours.

  • Merge rules: 1+ approval for low‑risk, 2+ for high‑risk. Hotfixes allowed only with incident reference and follow‑up PR.

23.0.3 Meeting Notes, Recordings & Access

  • Record working meetings; attach an agenda/notes doc in the invite.

  • Post‑meet automation: Within 2 hrs, drop the recording + notes link in the project channel with a 3–5 line decision summary.

  • Default share: Ensure stakeholders (internal leads/clients named in SOW) have access to all notes/recordings.

  • Index & audits: Maintain a single Meeting Notes Index per project; permission‑check monthly.

23.0.4 Security, Tools & Data Handling (Remote)

  • Device security: Full‑disk encryption required; approved antivirus; OS auto‑updates on.

  • Google Drive for Desktop: Disallowed by default. If good device practices are used and demonstrated a request for access will be granted.

  • AI tools: Use only the approved list. Connecting Company/Client Google accounts or syncing confidential files to third‑party AI tools is prohibited without written approval. Do not paste client secrets or sensitive datasets into public models.

  • Data classification: Tag work artifacts as Client Confidential / Company Confidential / Internal / Public and handle accordingly.

  • Account provisioning: Don’t sign up for new SaaS with Company SSO without approval; request via IT ticket.

23.0.5 Time Tracking & Backups

  • Tool: SolidTime (or successor) for time tracking.

  • Daily habit: Start timer at work start; pause for breaks; stop at checkout.

23.0.6 Onboarding — First Two Weeks (Remote‑first Ramp)

  • Week 0 (setup): Accounts, access, security posture, read the Handbook + project runbooks.

  • Week 1 (observe & mirror): Shadow meetings; follow the Collaboration norms; create Issues/PRs on a low‑risk starter task.

  • Week 2 (deliver WIP): Ship iterative PRs on a scoped task; practice daily check‑ins and post‑meet summaries.

23.0.7 Performance & Consequence Ladder (Collaboration‑First)

  • Signal: Missed daily visibility, no WIP PRs, or unresponsive code sharing.

  • Step 1: Written feedback with concrete expectations and a 1‑week improvement window.

  • Step 2: If no improvement, re‑assignment or contract reconsideration.

23.0.8 Issue Logging & Website/App Maintenance

  • Log bugs and UX issues (e.g., forms, clipboard, session state) as GitHub Issues with repro steps, expected vs actual, screenshots, and priority.

  • Owner & SLA: Assign an owner; P1s acknowledged same‑day and fixed or triaged within 12 hours.

23.0.9 Client Data & Compliance for Deployments

  • Separation: Dev/Test data isolated from Prod; use least‑privilege IAM and secrets management.

  • Privacy‑preserving integrations: Prefer designs that avoid handling raw PII where feasible; enable audit logs and access trails.

  • Runbooks: Each deployment has a runbook (rollback, on‑call, RPO/RTO targets).

23.0.10 Codebase Ownership & SLAs (Web & Apps)

  • Each repo has a named Owner and Back‑up.

  • Operational SLAs: Critical production bug fix ETA ≤ 12 business hours unless agreed otherwise; communicate status in‑channel.

23.0.11 AI‑Assisted Workflows & Prompt Library

  • Document significant AI prompts/recipes used for specs, tests, or code generation.

  • Share useful prompts to the internal library; avoid including proprietary client data.

23.0.12 Availability & Scheduling

  • Maintain your working hours and time‑zone in your Slack profile.

  • Post planned OOO ≥ 1 business day in advance in the team channel and add to the shared Availability calendar.

  • During overlapping hours, prefer synchronous stand‑ups; outside overlap, rely on async updates.