📁 Engineering/
│
├── 📁 _Templates/ ⭐ (All templates in ONE place)
│   ├── 📄 Performance-Review-Template.gdoc
│   ├── 📄 Individual-Learning-Plan-Template.gdoc
│   ├── 📄 Learning-Log-Template.gsheet ⭐ NEW
│   ├── 📄 1on1-Notes-Template.gdoc
│   ├── 📄 Promotion-Packet-Template.gdoc
│   ├── 📄 Incident-Report-Template.gdoc
│   ├── 📄 Post-Mortem-Template.gdoc
│   ├── 📄 Onboarding-Checklist-Template.gdoc
│   ├── 📄 Purchase-Request-Template.gdoc
│   └── 📄 _README.gdoc (How to use templates)
│
├── 📁 Official-Policies/ (Signed, versioned)
│   ├── 📄 2026-01-Engineering-Performance-Framework-SIGNED.pdf
│   ├── 📄 2026-01-Engineering-Career-Ladder-SIGNED.pdf
│   ├── 📄 2025-Engineering-Strategy-Vision.pdf
│   ├── 📄 Code-of-Conduct.pdf
│   ├── 📄 IP-and-Confidentiality-Agreement.pdf
│   └── 📁 Archive/
│       └── 📄 2025-01-Performance-Framework-SIGNED.pdf
│
├── 📁 People/ (Performance & career)
│   ├── 📁 Performance-Reviews/
│   │   ├── 📁 2026-H1/ (Half-yearly folders)
│   │   │   ├── 📄 2026-06-30-John-Doe-Review.gdoc
│   │   │   ├── 📄 2026-06-30-Jane-Smith-Review.gdoc
│   │   │   └── 📊 2026-H1-Calibration-Data.gsheet
│   │   └── 📁 2025-H2/
│   │
│   ├── 📁 Learning-Plans/ ⭐ (Track individual growth)
│   │   └── 📁 2026/
│   │       ├── 📄 2026-Q1-John-Doe-ILP.gdoc
│   │       ├── 📊 2026-John-Doe-Learning-Log.gsheet ⭐
│   │       ├── 📄 2026-Q1-Jane-Smith-ILP.gdoc
│   │       └── 📊 2026-Jane-Smith-Learning-Log.gsheet ⭐
│   │
│   ├── 📁 Promotions/
│   │   └── 📁 2026/
│   │       └── 📄 2026-03-John-Doe-Senior-Promotion.gdoc
│   │
│   ├── 📁 1on1-Notes/ (By manager, then direct report)
│   │   └── 📁 Sarah-Manager/
│   │       ├── 📁 John-Doe/
│   │       │   ├── 📄 2026-01-15.gdoc
│   │       │   └── 📄 2026-01-29.gdoc
│   │       └── 📁 Jane-Smith/
│   │
│   └── 📁 Performance-Improvement-Plans/
│       ├── 📁 Active/
│       └── 📁 Closed/
│
├── 📁 Onboarding/ (New hire tracking)
│   └── 📁 2026/
│       ├── 📄 2026-01-15-John-Doe-Onboarding.gdoc
│       └── 📄 2026-02-01-Jane-Smith-Onboarding.gdoc
│
├── 📁 Compliance/ (Audit evidence)
│   ├── 📁 SOC2-2026/
│   │   ├── 📊 Control-Evidence-Tracker.gsheet
│   │   ├── 📄 CC6.1-Access-Control-Evidence.gdoc
│   │   └── 📄 CC8.1-Change-Management-Evidence.gdoc
│   └── 📁 GDPR/
│       └── 📊 Data-Processing-Inventory.gsheet
│
├── 📁 Incidents/ (Major incidents only)
│   └── 📁 2026/
│       ├── 📄 2026-01-15-INC001-Payment-Outage.gdoc
│       └── 📄 2026-02-03-INC002-Database-Performance.gdoc
│
├── 📁 Budget/
│   ├── 📊 2026-Engineering-Budget.gsheet
│   ├── 📊 Learning-Development-Budget.gsheet ⭐ NEW
│   │   (Columns: Person | Request Date | Item/Course | Cost | Manager Approval | Status | Receipt)
│   ├── 📊 Tool-Licenses-Inventory.gsheet
│   └── 📁 Purchase-Requests/
│       └── 📄 2026-01-PR001-IDE-Licenses.gdoc
│
├── 📁 Hiring/
│   ├── 📁 Job-Descriptions/ (Living, not dated)
│   │   ├── 📄 Senior-Mobile-Engineer-JD.gdoc
│   │   └── 📄 Mid-Backend-Engineer-JD.gdoc
│   ├── 📊 2026-Candidate-Pipeline.gsheet
│   └── 📁 Offer-Letters/
│       └── 📁 2026/
│
├── 📁 Meeting-Notes/ (Official meeting records)
│   ├── 📁 All-Hands/
│   │   ├── 📄 2026-01-All-Hands.gdoc
│   │   └── 📄 2026-02-All-Hands.gdoc
│   ├── 📁 Leadership-Sync/
│   │   └── 📄 2026-Leadership-Weekly-Notes.gdoc
│   ├── 📁 Architecture-Guild/ ⭐
│   │   └── 📄 2026-Architecture-Guild-Notes.gdoc
│   ├── 📁 Show-and-Tell/ ⭐ NEW
│   │   ├── 📊 2026-Show-and-Tell-Log.gsheet
│   │   │   (Columns: Date | Presenter | Topic | Recording Link | Attendees)
│   │   └── 📁 Recordings/ (or links to video storage)
│   └── 📁 Tech-Talks/ ⭐ NEW
│       ├── 📊 2026-Tech-Talks-Schedule.gsheet
│       │   (Columns: Date | Speaker | Topic | Recording Link | Slides Link | Attendees)
│       └── 📁 Slides/
│
└── 📁 Reports/ (Quarterly business reports)
    └── 📁 2026/
        ├── 📄 2026-Q1-Engineering-Report.gdoc
        └── 📊 2026-Q1-Engineering-Metrics.gsheet

📁 docs/ (fumadocs root)
│
├── 📄 index.mdx (Welcome to Engineering @ Solutech)
│
├── 📁 getting-started/
│   ├── 📄 index.mdx (Your First Week)
│   ├── 📄 engineering-handbook.mdx (Company culture, values, how we work)
│   ├── 📄 team-structure.mdx (Org chart, team missions)
│   ├── 📄 tools-and-access.mdx (How to request access to tools)
│   ├── 📄 communication-norms.mdx (Slack, meetings, email)
│   └── 📄 first-contribution.mdx (How to make your first PR)
│
├── 📁 how-we-work/
│   ├── 📄 index.mdx (Engineering Processes Overview)
│   ├── 📄 sprint-process.mdx (2-week sprints, ceremonies)
│   ├── 📄 task-workflow.mdx (Jira workflow: New → In Progress → Done)
│   ├── 📄 code-review-process.mdx (PR guidelines, approval rules)
│   ├── 📄 git-workflow.mdx (Branching strategy, commit messages)
│   ├── 📄 deployment-process.mdx (How code gets to production)
│   ├── 📄 incident-response.mdx (On-call, escalation)
│   ├── 📄 three-amigos.mdx (Product + Dev + QA collaboration)
│   │
│   ├── 📁 bdd/
│   │   ├── 📄 index.mdx (BDD Overview - why we use it)
│   │   ├── 📄 bdd-workflow.mdx (The BDD process: 3 Amigos → Gherkin → Implementation)
│   │   ├── 📄 writing-scenarios.mdx ⭐ (How to write good Gherkin scenarios)
│   │   ├── 📄 feature-structure.mdx ⭐ (How to organize feature files by modules)
│   │   ├── 📄 step-definitions.mdx (How to write reusable step definitions)
│   │   ├── 📄 test-data-management.mdx (Managing test data in BDD)
│   │   ├── 📄 running-bdd-tests.mdx (How to run BDD tests locally and in CI)
│   │   └── 📄 bdd-best-practices.mdx (Common pitfalls and how to avoid them)
│   │
│   ├── 📁 learning-and-research/ ⭐ NEW
│   │   ├── 📄 index.mdx (Overview: Learning vs Research)
│   │   ├── 📄 personal-learning.mdx (How to track and grow your skills)
│   │   ├── 📄 knowledge-sharing.mdx ⭐ (HOW Show & Tell works, WHEN, FORMAT - not actual logs)
│   │   ├── 📄 tech-talks.mdx ⭐ (HOW to propose/deliver talks, PROCESS - not schedule)
│   │   ├── 📄 spike-process.mdx (When and how to spike)
│   │   ├── 📄 preventing-duplicate-research.mdx (Communication strategies)
│   │   └── 📄 learning-budget.mdx ⭐ (HOW to request budget, WHAT it covers - not tracking)
│   │
│   └── 📁 architecture-decisions/ ⭐ NEW
│       ├── 📄 index.mdx (Overview: RFC → ADR process)
│       ├── 📄 rfc-process.mdx (Request for Comments workflow)
│       ├── 📄 adr-process.mdx (Architecture Decision Records)
│       ├── 📄 research-guidelines.mdx (How to conduct technical research)
│       ├── 📄 spike-vs-rfc.mdx (When to spike vs when to RFC)
│       └── 📄 decision-levels.mdx (Company vs Platform vs Application)
│
├── 📁 standards/
│   ├── 📄 index.mdx (Standards Overview)
│   ├── 📄 coding-standards.mdx (General principles: DRY, SOLID, naming)
│   ├── 📄 api-design.mdx (RESTful conventions, versioning)
│   ├── 📄 database-standards.mdx (Naming, migrations, indexes)
│   ├── 📄 testing-standards.mdx (Unit, integration, E2E coverage)
│   ├── 📄 security-standards.mdx (OWASP, secrets management)
│   ├── 📄 documentation-standards.mdx (When/how to document)
│   ├── 📄 accessibility.mdx (WCAG compliance)
│   │
│   └── 📁 architecture-patterns/
│       ├── 📄 index.mdx (Architecture Standards Overview)
│       ├── 📄 mobile-architecture.mdx ⭐ (Standard Flutter architecture for ALL mobile apps)
│       ├── 📄 backend-architecture.mdx ⭐ (Standard Laravel architecture for ALL backends)
│       ├── 📄 web-architecture.mdx ⭐ (Standard Vue/Nuxt architecture for ALL web apps)
│       └── 📄 architectural-exceptions.mdx (When/how to deviate from standards)
│
├── 📁 architecture/
│   ├── 📄 index.mdx (System Architecture Overview)
│   ├── 📄 technology-radar.mdx (Adopt, Trial, Assess, Hold)
│   ├── 📄 design-patterns.mdx (Common patterns we use)
│   ├── 📄 integration-patterns.mdx (How systems talk to each other)
│   │
│   ├── 📁 rfcs/ ⭐ NEW (Request for Comments - Research phase)
│   │   ├── 📄 index.mdx (Active RFC Registry - auto-updated)
│   │   ├── 📄 template.mdx (RFC template)
│   │   │
│   │   ├── 📁 open/ (Currently researching)
│   │   │   ├── 📄 001-evaluating-monitoring-solutions.mdx
│   │   │   ├── 📄 002-event-streaming-comparison.mdx
│   │   │   └── 📄 003-api-gateway-options.mdx
│   │   │
│   │   └── 📁 resolved/ (Became ADRs or were rejected)
│   │       ├── 📄 001-evaluating-state-management.mdx → ADR-005
│   │       └── 📄 002-database-replication-strategy.mdx (Rejected)
│   │
│   ├── 📁 decisions/ (Architecture Decision Records - Company-wide Level 1)
│   │   ├── 📄 index.mdx (All ADRs index)
│   │   ├── 📄 template.mdx (ADR template)
│   │   ├── 📄 001-chose-laravel.mdx
│   │   ├── 📄 002-chose-flutter.mdx
│   │   ├── 📄 003-microservices-strategy.mdx
│   │   └── 📄 004-event-driven-architecture.mdx
│   │
│   ├── 📁 mobile/ ⭐ (Platform-specific Level 2)
│   │   ├── 📄 index.mdx (Mobile Architecture Overview)
│   │   ├── 📄 flutter-standard.mdx (Standard architecture for ALL Flutter apps)
│   │   │
│   │   ├── 📁 rfcs/ ⭐ NEW
│   │   │   ├── 📁 open/
│   │   │   │   └── 📄 M-003-offline-sync-strategies.mdx
│   │   │   └── 📁 resolved/
│   │   │
│   │   └── 📁 decisions/ (Platform-wide mobile ADRs - Level 2)
│   │       ├── 📄 M-001-bloc-over-riverpod.mdx
│   │       ├── 📄 M-002-drift-for-local-storage.mdx
│   │       └── 📄 M-003-firebase-push-notifications.mdx
│   │
│   ├── 📁 backend/ ⭐ (Platform-specific Level 2)
│   │   ├── 📄 index.mdx (Backend Architecture Overview)
│   │   ├── 📄 laravel-standard.mdx (Standard architecture for ALL Laravel apps)
│   │   │
│   │   ├── 📁 rfcs/ ⭐ NEW
│   │   │   ├── 📁 open/
│   │   │   │   └── 📄 B-004-rate-limiting-implementation.mdx
│   │   │   └── 📁 resolved/
│   │   │
│   │   └── 📁 decisions/ (Platform-wide backend ADRs - Level 2)
│   │       ├── 📄 B-001-repository-pattern-mandatory.mdx
│   │       ├── 📄 B-002-api-versioning-strategy.mdx
│   │       └── 📄 B-003-redis-for-caching.mdx
│   │
│   └── 📁 web/ ⭐ (Platform-specific Level 2)
│       ├── 📄 index.mdx (Web Architecture Overview)
│       ├── 📄 vue-standard.mdx (Standard architecture for ALL Vue apps)
│       │
│       ├── 📁 rfcs/ ⭐ NEW
│       │   ├── 📁 open/
│       │   └── 📁 resolved/
│       │
│       └── 📁 decisions/ (Platform-wide web ADRs - Level 2)
│           ├── 📄 W-001-composition-api-mandatory.mdx
│           ├── 📄 W-002-pinia-over-vuex.mdx
│           └── 📄 W-003-playwright-for-e2e.mdx
│
├── 📁 applications/
│   ├── 📄 index.mdx (All Applications Overview)
│   │
│   └── 📁 solutech-sat/
│       ├── 📄 index.mdx (What is SAT? Product overview, user personas)
│       ├── 📄 architecture.mdx (High-level: Mobile + Backend + Web, data flow)
│       ├── 📄 getting-started.mdx (Which repos to clone, quick start)
│       │
│       ├── 📁 mobile/
│       │   ├── 📄 index.mdx (Overview + link to repo)
│       │   └── 📄 repo-link.mdx (👉 Detailed docs in solutech-sat-mobile/docs)
│       │
│       ├── 📁 backend/
│       │   ├── 📄 index.mdx (Overview + link to repo)
│       │   └── 📄 repo-link.mdx (👉 Detailed docs in solutech-sat-backend/docs)
│       │
│       ├── 📁 web/
│       │   ├── 📄 index.mdx (Overview + link to repo)
│       │   └── 📄 repo-link.mdx (👉 Detailed docs in solutech-sat-web/docs)
│       │
│       └── 📄 operations.mdx (Where to check logs, monitoring dashboards)
│
├── 📁 teams/
│   ├── 📄 index.mdx (Engineering Teams)
│   ├── 📄 mobile.mdx (Mission, members, tech stack)
│   ├── 📄 backend.mdx
│   ├── 📄 qa.mdx
│   ├── 📄 security.mdx
│   ├── 📄 data.mdx
│   └── 📄 design.mdx
│
├── 📁 infrastructure/
│   ├── 📄 index.mdx (Infrastructure Overview)
│   ├── 📄 environments.mdx (Dev, Staging, Production)
│   ├── 📄 ci-cd.mdx (GitHub Actions, deployment pipeline)
│   ├── 📄 monitoring.mdx (Where to check metrics)
│   └── 📄 incident-runbooks.mdx (Common issues, how to resolve)
│
├── 📁 career/
│   ├── 📄 index.mdx (Career Development)
│   ├── 📄 career-ladder.mdx (Link to official Google Drive PDF)
│   ├── 📄 performance-framework.mdx (How performance is measured)
│   ├── 📄 promotion-process.mdx (How to get promoted)
│   ├── 📄 mentorship.mdx (How mentorship works)
│   └── 📄 learning-resources.mdx ⭐ (Books, courses, conferences)
│
└── 📁 reference/
    ├── 📄 glossary.mdx (Terms, acronyms)
    ├── 📄 jira-workflow.mdx (Status definitions)
    └── 📄 useful-links.mdx (Google Drive, GitHub, Jira, etc.)

📁 solutech-sat-mobile/ (or any application repo)
│
├── 📄 README.md ⭐ MANDATORY
│
├── 📄 CONTRIBUTING.md ⭐ MANDATORY
│
├── 📄 CHANGELOG.md ⭐ MANDATORY
│
├── 📁 docs/ ⭐ MANDATORY
│   ├── 📄 architecture.md ⭐ MANDATORY
│   ├── 📄 setup.md ⭐ MANDATORY
│   ├── 📄 development.md ⭐ MANDATORY
│   ├── 📄 testing.md ⭐ MANDATORY
│   ├── 📄 deployment.md (If team deploys)
│   ├── 📄 api.md (For backend services)
│   ├── 📄 troubleshooting.md
│   │
│   ├── 📁 rfcs/ ⭐ NEW (Application-specific research - Level 3)
│   │   ├── 📄 README.md (How to use RFCs in this repo)
│   │   ├── 📁 open/ (Currently researching)
│   │   │   └── 📄 001-evaluating-offline-sync.md
│   │   └── 📁 resolved/ (Became ADRs or were rejected)
│   │       └── 📄 001-offline-sync-decision.md → ADR-002
│   │
│   └── 📁 adrs/ (Application-specific decisions ONLY - Level 3)
│       ├── 📄 README.md (How to write ADRs)
│       ├── 📄 template.md
│       ├── 📄 001-why-we-need-custom-cache.md
│       ├── 📄 002-offline-sync-strategy.md
│       └── 📄 003-push-notification-provider.md
│
├── 📁 features/ ⭐ MANDATORY (BDD Gherkin behaviour specifications)
│   ├── 📄 authentication.feature
│   ├── 📄 order-management.feature
│   ├── 📄 customer-management.feature
│   └── 📄 offline-sync.feature
│
├── 📁 test/
│   ├── 📁 unit/
│   ├── 📁 integration/
│   └── 📁 e2e/
│
└── 📁 .github/
    └── 📁 workflows/
        ├── 📄 ci.yml
        └── 📄 bdd-report.yml

Personal Learning → Team Sharing → Spike → RFC → ADR
     ↓                 ↓           ↓      ↓     ↓
  No docs        Slack/Demo    Branch  Formal  Decision

Research Phase (RFC) → Decision Phase (ADR)
    2-4 weeks              Final

# RFC-XXX: [Question Being Researched]

**Status:** Open | Under Review | Resolved → ADR-XXX | Rejected  
**Level:** Company-Wide | Platform | Application  
**Author:** Name  
**Date:** YYYY-MM-DD

## Problem Statement

What problem are we solving?

## Options Investigated

### Option 1: [Name]

**Pros:** ...  
**Cons:** ...  
**Spike Results:** Link to branch

### Option 2: [Name]

...

## Comparison Matrix

| Criteria    | Option 1 | Option 2 |
| ----------- | -------- | -------- |
| Performance | Fast     | Medium   |

## Open Questions

- Question 1?

## Next Steps

- [ ] Task (Owner, Due Date)

## Resolution

**Date:** YYYY-MM-DD  
**Outcome:** Chose Option X  
**ADR:** Link to ADR-XXX

# ADR-XXX: [Decision Made]

**Status:** Accepted | Superseded by ADR-YYY  
**Date:** YYYY-MM-DD  
**Level:** 1 | 2 | 3  
**Platform:** Mobile | Backend | Web (if Level 2/3)

## Context

What problem does this solve?

## Decision

We will [decision].

## Consequences

**Positive:**

- Benefit 1

**Negative:**

- Trade-off 1

## Related

- RFC-XXX (research that led here)
- ADR-YYY (supersedes this)