-
Notifications
You must be signed in to change notification settings - Fork 1
Conventions Naming Standards
Cengiz Ilerler edited this page Apr 25, 2026
·
13 revisions
[Role].[Environment]@mycompany.local
| Component | Naming Pattern | Dead Letter Suffix |
|---|---|---|
| Exchange | [myApp].[myModule].exchange |
.dlx |
| Routing Key | [myApp].[myModule].[myEvent/myAction] |
|
| Queue | [myApp].[myModule].[myConsumer].[myEvent/myAction].queue |
.dlq |
Given the project name Company.Project.Descriptor.csproj, here are the recommended naming patterns for each artifact:
| Artifact | Naming Pattern | Notes |
|---|---|---|
| NuGet Package Name | Company.Project.Descriptor | |
| Docker Image Name | company-project-descriptor | Replace each . with -
|
| URL Public | https://descriptor.project.environment.company.app | |
| URL Private | https://descriptor.project.environment.company.internal | |
| URL Private (dev) | https://descriptor.project.environment.company.local | |
| URL Private K8S (dev) | https://descriptor.project.environment.svc.cluster.local | |
| URL Private K8S | https://descriptor.project.environment.svc.cluster.internal |
{Project}.{TestType}.Tests
myproduct-domain
meta : Centralized tracking for bugs, feature requests, milestones, and project initiatives across all related repositories.
dev-toolkit : Local development toolkit including environment setup, scripts, and supporting resources.
host : Core backend handling API endpoints, background event processing, migrations, and scheduled tasks.
portal : User-facing web app for managing accounts and services.
gateway : Reverse proxy handling TLS termination, traffic routing, and webhook ingestion.
e2e : Automated end-to-end tests covering critical product workflows across frontend and backend components.
.NET Solution
Attachments convention (
/docs/only): per-document supporting files (diagrams, screenshots, spreadsheets, raw data, recordings) live in a sibling/attachments/{basename}/folder, where{basename}is the document filename without.md. Exceptions are flagged inline in the tree:
- Singletons at
/docs/root (business-glossary.md,data-dictionary.md,tech-stack-overview.md) — no/attachments/.- Non-markdown reference folders (
/specs,/diagrams,/notebooks) — no/attachments/; those files are the artifacts.
/.vscode // Visual Studio Code settings
- settings.json // Workspace settings
- launch.json // Debugging configuration
- tasks.json // Task configuration
- extensions.json // Recommended extensions
/.git // Git configuration
- config // Git configuration file
/.github // GitHub configuration
- CODEOWNERS // Code owners for the repository
- PULL_REQUEST_TEMPLATE.md // Pull request template
/ISSUE_TEMPLATE // Issue templates
- bug_report.yml // Bug report template
- feature_request.yml // Feature request template
- custom_template.yml // Custom template
/workflows // GitHub Actions workflows
- ci.yml // CI/CD pipeline for continuous integration
- checks.yml // CI/CD pipeline for running checks and tests
/docs // App-level documentation
- README.md // Master index — pointers to sections below
- business-glossary.md // SINGLETON — no /attachments/ (promote to its own typed folder if support material is needed)
- data-dictionary.md // SINGLETON — no /attachments/
- tech-stack-overview.md // SINGLETON — no /attachments/
/adrs // Architecture Decision Records — why we chose X over Y (immutable once accepted)
- {yyyyMMddHHmm}-{slug}.md // One decision per file (e.g. 202504141430-use-event-sourcing.md)
/attachments
/{yyyyMMddHHmm}-{slug} // Per-doc supporting files (diagrams, screenshots, data, recordings)
/rfcs // Request for Comments — proposals under discussion, may or may not be accepted
- {yyyyMMddHHmm}-{slug}.md
/attachments
/{yyyyMMddHHmm}-{slug}
/designs // Technical Design Documents — narrative explanation of how a feature/system works
- {yyyyMMddHHmm}-{slug}.md
/attachments
/{yyyyMMddHHmm}-{slug}
/specs // Machine-readable contract definitions — OpenAPI, GraphQL, JSON Schema, etc. (no /attachments/ — these ARE the artifacts)
- {slug}.yaml
- {slug}.json
/diagrams // Shared system/architecture diagrams referenced by multiple docs (no /attachments/ — these ARE the artifacts)
- {slug}.puml // PlantUML source
- {slug}.excalidraw // Excalidraw source
- {slug}.mermaid // Mermaid source
/notebooks // Jupyter notebooks for analysis or runnable examples (no /attachments/ — these ARE the artifacts)
- {slug}.ipynb
/runbooks // App-wide operational procedures (deploy, backup, restore, etc.)
- {slug}.md // Living documents — no date prefix (updated as systems evolve)
/attachments
/{slug}
/sops // Standard Operating Procedures — formalized org processes
- {yyyyMMddHHmm}-{slug}.md
/attachments
/{yyyyMMddHHmm}-{slug}
/pirs // Post Incident Reviews — what broke, why, how we fixed it
- {yyyyMMddHHmm}-{slug}.md
/attachments
/{yyyyMMddHHmm}-{slug}
/test-plans // App / release-level test strategy (opt-in; required in regulated contexts)
- {yyyyMMddHHmm}-{slug}.md // Use when scope is a release or initiative not tied to a P{N} project
/attachments
/{yyyyMMddHHmm}-{slug}
/test-cases // QA verification of acceptance criteria
- {slug}.md // Living documents — no date prefix (updated as features change)
/attachments
/{slug}
/tickets // Per-ticket working artifacts and handoffs
/GITHUB-{N} // Always a folder; one per ticket (identifier from external tracker, e.g. GITHUB-{N})
- Handoff.md // REQUIRED — final handoff summary at ticket resolution
/attachments
/Handoff // Subfolder name matches doc basename — holds scripts, screenshots, investigation notes, raw data, recordings
/projects // Per-project working artifacts and documentation
/P{N} // Always a folder; one per project (sequential internal ID: P1, P2, P3, ...)
- BusinessCase.md // REQUIRED — initiates the project (scope, rationale, approval)
- BusinessCaseFinancialModel.md // Optional — financial evaluation (OPEX/CAPEX, ROI, payback period)
- Retrospective.md // End-of-project retrospective
- TestPlan.md // Optional — project-scoped test strategy (sits alongside BusinessCase)
/StatusUpdates // Iterative status reports over the life of the project
- {yyyyMMddHHmm}-{slug}.md
/attachments
/{yyyyMMddHHmm}-{slug} // Per-update supporting files
/attachments
/BusinessCase // Each subfolder matches a doc basename in this folder
/BusinessCaseFinancialModel
/Retrospective
/TestPlan
/tools
/Kubernetes
- kustomization.yaml // Kustomize configuration for Kubernetes
/base
- kustomization.yaml // Base kustomize configuration for Kubernetes
- deployment.yaml // Base deployment configuration for Kubernetes
- service.yaml // Base service configuration for Kubernetes
/overlays
/integration
/base // Base configuration for Integration environment
- kustomization.yaml // Base kustomize configuration for Integration environment
- deployment.yaml // Base deployment configuration for Integration environment
- service.yaml // Base service configuration for Integration environment
/default // Default configuration for Integration environment
- kustomization.yaml // Default kustomize configuration for Integration environment
- deployment.yaml // Default deployment configuration for Integration environment
- service.yaml // Default service configuration for Integration environment
/alternative // Alternative configuration for Integration environment
- kustomization.yaml // Alternative kustomize configuration for Integration environment
- deployment.yaml // Alternative deployment configuration for Integration environment
- service.yaml // Alternative service configuration for Integration environment
/testing
/base
- kustomization.yaml
- deployment.yaml
- service.yaml
/default
- kustomization.yaml
- deployment.yaml
- service.yaml
/alternative
- kustomization.yaml
- deployment.yaml
- service.yaml
/staging
/base
- ...
/default
- ...
/alternative
- ...
/production
/...
/tests
- App.http // Cross-module HTTP request tests
- {ModuleName}.http // Cross-component tests within a module
- {ComponentName}.http // Cross-service tests within a component
- {ServiceName}.http // Tests for one service's API endpoints
/Company.Project.Domain.Integration.Tests
- Company.Project.Domain.Integration.Tests.csproj
- EnterpriseServiceTests.cs
/Company.Project.Domain.Unit.Tests
- Company.Project.Domain.Unit.Tests.csproj
- EnterpriseServiceTests.cs
/Company.Project.Host.E2E.Tests
- Company.Project.Host.E2E.Tests.csproj
- HealthCheckTests.cs
/Company.Project.Host.Integration.Tests
- Company.Project.Host.Integration.Tests.csproj
- HealthCheckTests.cs
/Company.Project.Host.Unit.Tests
- Company.Project.Host.Unit.Tests.csproj
- HealthCheckTests.cs
/Company.Project.Tests.Common // Shared test utilities, fixtures, mocks
- Company.Project.Tests.Common.csproj
/...
.dockerignore // Docker ignore file
.editorconfig // Editor configuration file
.gitattributes // Git attributes file
.gitignore // Git ignore file
LICENSE // License file
README.md // Readme file explains the project
CHANGELOG.md // Changelog file for the project
azure-pipelines.yml // Azure DevOps pipeline configuration
Company.Solution.sln // Visual Studio solution file
/src
/Company.Project.Abstractions
/Company.Project.Extensions
/Company.Project.Domain
/Company.Project.Host
- Program.cs // Entry point for the application
- ProgramExtensions.cs // Extension methods for the program
- StartupBackgroundService.cs // Initial background service for the application
- StartupHealthCheck.cs // Health check for the application
- AppConfigurationExtensions.cs // Configuration extensions for the application
- appsettings.json // Configuration settings for the application
- appsettings.Development.json // Configuration settings for the development environment
- appsettings.Integration.json // Configuration settings for the integration environment
- appsettings.Testing.json // Configuration settings for the testing environment
- appsettings.Staging.json // Configuration settings for the staging environment
- appsettings.Production.json // Configuration settings for the production environment
- Dockerfile // Docker configuration for containerization
- Company.Project.Host.csproj // Project file
- Directory.Build.props // Common properties for all projects in the solution
- Buildinfo.txt // Build information to show when the app starts
- App.razor // Main application component
- Routes.razor // Route configuration for the application
/Properties
- launchSettings.json // Debugging settings for the project, Visual Studio and .NET Core CLI
/Resources
/SQL
- Constants.cs
- Query1.sql
- Query2.sql
- ...
/...
/wwwroot
- index.html // Default HTML file for the application
- favicon.ico // Favicon for the application
- ...
/css
- app.css
- ...
/Pages
- Page1.razor // Razor page for the application
- Page2.razor
- ...
/PageComponents
- PageComponent1.razor // Page component for the application
- PageComponent2.razor
- ...
/Layout
- MainLayout.razor // Main layout component
- NavMenu.razor // Navigation menu component
- _Imports.razor // Import statements for the application
/Abstractions // App-wide shared contracts (cross-module)
/Events
/Interfaces
/Models // Enums, value objects, shared DTOs
/Requests
/Responses
/Contracts // App-wide internal interfaces for shared helpers
/Exceptions // App-wide base exceptions
/Extensions
- StartupExtensions.cs // Registers all modules
/Internals // App-wide shared helper implementations
/Observability
/Grafana // Platform overview dashboard
- dashboard.json
/Modules
/Module1
/Abstractions // Module's public contract (cross-module)
/Events
/Interfaces
/Models
/Requests
/Responses
/Contracts // Module-wide internal interfaces for shared helpers
/Docs // Module-scoped documentation (optional)
/adrs // Module-specific architectural decisions
/rfcs // Module-specific proposals
/runbooks // Module-level operational procedures
/Exceptions // Module-level base exceptions
/Extensions
- StartupExtensions.cs // Registers all components in this module
/Internals // Module-wide shared helper implementations
/Observability
/Grafana // Module-level domain health dashboard
- dashboard.json
- Constants.cs // Module-wide constants
/Component1 // Always required (even single-component modules)
/Abstractions // Component's public contract (cross-component)
/Events
/Interfaces
/Models
/Requests
/Responses
/Contracts // Component-wide internal interfaces for shared helpers
/Docs // Component-scoped documentation (optional)
/adrs // Component-specific architectural decisions
/rfcs // Component-specific proposals
/runbooks // Component-level operational procedures
/Exceptions // Component-level base exceptions
/Extensions
- StartupExtensions.cs // Registers all services in this component
/Internals // Component-wide shared helper implementations
/Observability
/Grafana // Component-level aggregated dashboard
- dashboard.json
- Constants.cs // Component-wide constants
/Service1 // Full service structure
/Abstractions // Public contract (cross-service)
/Events // Domain events
/Interfaces // Public interfaces (when externally consumed)
/Models // Enums, value objects, shared DTOs
/Requests // Request DTOs
/Responses // Response DTOs
/Api // HTTP endpoints (optional)
- {ServiceName}Api.cs // Route group definition
- {Verb}Endpoint.cs // One file per endpoint
/Clients // External HTTP API wrappers
/Configuration // Settings and config binding
- {ServiceName}Settings.cs
/Contracts // Internal interfaces (DI/testing)
- I{ServiceName}.cs // Default: internal
/Docs // Service-scoped documentation (optional)
- README.md // Service overview
- runbook.md // Service-specific operational procedures
- test-plan.md // Service-specific test strategy
/Exceptions // Service-specific exceptions
/Extensions // DI registration, model extensions
- StartupExtensions.cs
/Internals // Internal helper implementations
/Mappers // Object mapping between types
/Models // Internal entities/domain objects
/Observability // Dashboards and diagnostics
/Grafana // Per-service dashboard
- dashboard.json
/Resources // Embedded resource files — optional (SQL, templates, etc.)
/SQL
- {Name}.sql
- ResourceLoader.cs // Lazy loader for embedded resources
- Constants.cs // Resource file name constants
/Validators // Custom validation attributes
- Constants.cs // Service constants + Metrics nested class
- {ServiceName}Service.cs // Core business logic
- {ServiceName}Worker.cs // Background service lifecycle (optional)
- {ServiceName}HealthCheck.cs // Health monitoring (optional)
/Service2
/...
/Component2
/...
/Module2
/...
Workspace
[!CAUTION] Do not use AI on the
/local/archives,/local/_git-bare, and/local/docsfolders. They probably contain sensitive, private information that must not be processed or shared with any AI models.
/Source // Root directory located at %USERPROFILE%\Source
/local // Local and machine-specific files
/!nuget // Private offline NuGet packages
/archives // Repository backups (settings, tool data, user secrets)
/_temp // Temporary extraction folder for packed backups (should not be visible unless an error occurs)
/local__git-bare_UserSecrets.$timestamp.bundle // Bundled user secrets repository
/local__git-bare_local_knowledgebase_personal.$timestamp.bundle // Bundled knowledgebase repository
/local__git-bare_local_docs_personal.$timestamp.bundle // Bundled local notes repository
/local_sandbox_$pocName1.bundle // Bundled sandbox repository for PoC 1
/local_sandbox_$pocName2.bundle // Bundled sandbox repository for PoC 2
/github_$user_$repository.bundle // Bundled GitHub repository
/vsts_$organization_$repository.bundle // Bundled Azure DevOps repository
/vsts_$organization_DefaultCollection_$repository.zip // Zipped Azure DevOps repository
/assembla_$organization_$repository.zip // Zipped Assembla repository
/bitbucket_$organization_$repository.bundle // Bundled BitBucket repository
/_git-bare
/local
/knowledgebase // Bare repository for knowledgebase
/docs
/personal // Bare repository for personal notes
/...
/UserSecrets // Bare repository for user secrets
/sandbox // Experimental code and Proof-of-Concepts (PoCs)
/knowledgebase // Knowledgebase organized by unit
/personal // personal knowledgebase
.editorconfig // Editor configuration for coding style
.gitignore // Git ignore patterns for this repository
.gitattribute // Git attributes configuration
/home
/trash // Staging area for files pending deletion
/dump // Unsorted notes requiring classification or relocation
/temp // Temporary scratch files with limited lifespan
/private // Private notes, not for external distribution
/<private subject 1>
/public // Snippets suitable for sharing
/<public subject 1>
/global // Snippets relevant across multiple units
/dev // General development-related snippets
/powershell
README.md // Markdown-formatted code snippets
...
/...
/notebook
README.md // Markdown-formatted code snippets
.env // Environment variables for notebook execution
sample.dib // Example polyglot notebook (.dib)
sample.ipynb // Example Jupyter notebook (.ipynb)
/...
/...
/...
/docs
/personal // Personal notes repository
.editorconfig // Editor configuration for coding style
.gitignore // Git ignore patterns for this repository
.gitattribute // Git attributes configuration
/.vscode // Visual Studio Code workspace settings
/.workspaces // Visual Studio Code multi-root workspace definitions
/home
/trash // Staging area for files pending deletion
/dump // Unsorted notes requiring classification or relocation
/temp // Temporary scratch files with limited lifespan
/private // Private notes, not for external distribution
/<private subject 1>
/public // Notes suitable for sharing
/<public subject 1>
/global // Notes relevant across multiple units
Diary.md // Daily work log or journal
/dev // General development-related notes
Scratchpad.md // Quick code experiments and scratchpad
/tickets // Notes specific to support tickets
/<ticket1>
00-ActionPlan.md // Summary of objectives, scope, and sequence of actions
01-ValidationChecklist.md // Validations to confirm expected outcomes
02-RollbackInstructions.md // Fallback steps in case execution needs to be reverted
11-PepareEnvironment.ps1 // Pre-task infra adjustments (e.g., scale down services)
12-PreChecks.md // Verify pre-conditions (schema state, data quality)
13-Step1_TransformData.cs // First logical unit of data manipulation or migration
14-Step2.1_ModifySchemaForX.sql // Schema or structural changes (e.g., indexes, tables) for reason X
15-Step2.2_ModifySchemaForY.sql // Schema or structural changes (e.g., indexes, tables) for reason Y
16-Step3_TransformData.cs // Second logical unit of data manipulation or migration
17-Cleanup.md // Post-processing cleanup (temporary tables, flags, etc.)
18-RestoreEnvironment.ps1 // Infra restoration steps (e.g., scale up services again)
// ...
99-ExecutionSummary.md // Notes, logs, and summary from the task execution
/...
/projects // Notes specific to ongoing projects
/<project1>
/...
/repositories // Notes specific to code repositories
/<repo1>
/...
/middleware // Middleware, integration scripts, and helper utilities
/certificates // Certificates, keys, and security credentials
/...
/...
/...
/github
/<username> // User-specific GitHub repositories
/<repository> // Specific repository directory
/dotnet // Repositories related to .NET
/dotnet-architecture // Repository for .NET architecture resources
/OData // Repositories related to OData
/RESTier // Repository for the RESTier project
/...
/vsts // Azure DevOps (formerly VSTS) repositories
/<organization> // Azure DevOps organization
/<repository> // Specific repository directory
/...
/...
Company Taxonomy
MyCompany/
├── Administration/
| ├── Finance/
| │ ├── BankCorrespondence/
| │ │ ├── CitiBusiness/
| │ │ │ └── 20251001_account-inactivity-notice_XXXX1234.pdf
| │ │ └── Chase/
| │ │ │ ├── 20231214_offer.pdf
| │ │ │ └── 20231231_notice.pdf
| │ ├── BankStatements/
| │ │ ├── BankOfAmerica/
| │ │ │ ├── 202312_statement.pdf
| │ │ │ └── 202401_statement.pdf
| │ │ └── Chase/
| │ │ │ ├── 202312_statement.pdf
| │ │ │ └── 202401_statement.pdf
| │ ├── CreditCards/
| │ │ ├── Amex_XXXX/
| │ │ │ ├── 202312_statement.pdf
| │ │ │ └── 202401_statement.pdf
| │ │ └── Chase/
| │ │ │ ├── 202312_statement.pdf
| │ │ │ └── 202401_statement.pdf
| │ ├── DebtAndFinancing/
| │ │ └── BankOfAmerica_LineOfCredit_XXXX/
| │ │ ├── loan_agreement_2025-02-11.pdf
| │ │ ├── amortization_schedule.xlsx
| │ │ └── Payments/
| │ │ └── 2025/
| │ │ └── 2025-10-01_payment_confirmation.pdf
| │ ├── ShareholderTransactions/
| │ │ ├── Distributions/
| │ │ └── OwnerLoanRepayaments/
| │ │ ├── promissory-note_2024-01-10.pdf
| │ │ └── 2025/
| │ │ └── 2025-10-02_loan-repayment_confirmation.pdf
| │ ├── Taxes/
| │ │ ├── 2023/
| │ │ └── 2024/
| │ ├── Payroll/
| │ │ ├── 2023/
| │ │ └── 2024/
| │ ├── Expenses/
| │ │ ├── Reports/
| │ │ ├── Receipts/
| │ │ ├── VendorInvoices/
| │ │ └── ContractorInvoices/ (shortcuts to contractor folders)
| │ ├── Invoices/
| │ │ ├── ClientInvoices/ (shortcuts to client folders)
| │ ├── Accounting/
| │ | ├── QuickBooksExports/
| │ | └── YearEndReports/
| │ └── Treasury/
| │ ├── BankAccounts/
| │ │ └── Citi_Business_Checking_XXXX1234/
| │ │ ├── account_info_form.pdf
| │ │ └── voided_check.png
| │ ├── CreditCards/
| │ │ └── Chase_Business_XXXX5678/
| │ │ ├── scan_front.jpg
| │ │ └── scan_back_redacted_cvv.jpg
| │ └── DebitCards/
| │ └── Citi_Business_Debit_XXXX9876/
| │ ├── scan_front.jpg
| │ └── scan_back_redacted_cvv.jpg
| |
| ├── Legal/
| | ├── ArticlesOfIncorporation/ # Filed with FL Division of Corporations
| | ├── Bylaws/ # Current and historical versions
| | ├── ShareholderAgreement/ # Buy-sell, drag-along, etc.
| | ├── BoardMinutes_Resolutions/ # Minutes, written consents, notices, waivers
| | ├── StockLedger/ # CSV/XLS showing holders and share counts
| | ├── StockCertificates/ # PDFs of signed certs (or DRS statements)
| | ├── EquityPlans_OptionGrants/ # 409A, option agreements, SAFE/NOTE docs
| | ├── SCorp_Election/ # Form 2553 and IRS acceptance letter
| | ├── AnnualReports_StateFilings/ # FL annual reports, amendments, foreign quals
| | | └── 2025_FL_annual-report_payment-receipt.pdf
| | ├── Licenses/ # State, county, professional, reseller
| | │ ├── 2025_Palm-Beach-County_business-tax-receipt.pdf
| | │ └── 2025_Boca-Raton_business-license-renewal.pdf
| | ├── GovernmentCorrespondence/ # Official, non-tax correspondence with government agencies (IRS, State, City)
| | | ├── 20251002_IRS_address-change-confirmation.pdf
| | | └── 20250925_FL-Dept-of-State_address-change_filed.pdf
| | ├── GoodStandingCertificates/ # Florida and any other states
| | ├── Contracts_IP/ # IP assignment, SaaS terms, MSA templates
| | ├── Trademarks_Patents/ # USPTO filings, office actions
| | ├── Compliance/ # SOC 2, PCI, data-processing addenda, BOI*
| | ├── NDAs/ # One-off NDAs that don’t belong in Clients/
| | ├── Insurance/ # GL, E&O, cyber, workers comp, D&O
| | └── RegisteredAgent/ # Service-of-process contract and renewals
| |
| └── HumanResources/
| ├── EmployeeRecords/ # split into Active/Former or use year folders
| │ ├── TaxForms/ # W-4s, 1099s, I-9s with IDs kept separate
| │ ├── PerformanceReviews/ #
| │ ├── CompensationLetters/ # offer letters, merit increases, equity grants
| │ └── Terminations/ # exit checklist, COBRA notices, release forms
| ├── PoliciesAndProcedures/ # already present
| ├── Benefits/ # plan docs, enrollments, ACA 1095s
| ├── TimeOff_Leave/ # PTO requests, FMLA, parental-leave paperwork
| ├── Compliance/ # EEOC logs, OSHA 300, harassment training certs
| ├── TrainingOnboarding/ #
| │ ├── EmployeeOnboarding/ #
| │ ├── ContractorTraining/ #
| │ └── ContinuousEducation/ #
| ├── JobDescriptions/ # current postings and baseline role profiles
| ├── BackgroundChecks/ # reports and consent forms (lock this down)
| └── Hiring/ #
| ├── Requisitions/ # approved headcount authorizations
| └── Candidates/ # resumes, interview notes, decision sheets
|
├── Internal/
│ ├── ToolsAndAccess/
│ ├── Templates/
│ ├── Strategy/
| | ├── CompanyVision.md
| | ├── AnnualObjectives_2025.md
| | ├── ProductRoadmap_Q3_2025.md
| | ├── CompetitiveLandscape_2025.md
| | ├── SWOT_2025.md
| | ├── PricingStrategy.md
| | ├── Go-to-market_Playbook.md
| | ├── GrowthExperiments.md
| | └── RiskRegister.md
| └── SOPs/
| ├── Business/
| │ ├── NewClient_Onboarding.md
| │ ├── Contractor_Engagement.md
| │ └── Invoice_Issue_Resolution.md
| ├── Admin/
| | ├── Payroll_Run.md
| | ├── Quarterly_Tax_Filing.md
| | └── Expense_Approval_Flow.md
| ├── IncidentResponse/
| │ ├── SeverityLevels.md
| │ ├── OnCall_Handoff.md
| │ └── Postmortem_Template.md
| ├── Engineering/
| │ ├── CodeReview.md
| │ ├── BranchStrategy.md
| │ ├── ReleaseChecklist.md
| │ ├── HotfixProcedure.md
| │ └── ADR_Template.md
| └── DevOps/
| ├── KubernetesRollback.md
| └── Observability_Setup.md
├── Marketing/
| ├── WebsiteAssets/ # stays
| │ ├── Copy/ # markdown drafts
| │ ├── Images/ # optimized JPG/PNG, no PSD
| │ ├── Wireframes/ # Figma exports, mock-ups
| │ └── Builds/ # zipped static site snapshots
| ├── SocialMedia/
| │ ├── Calendar/ # posting schedule CSVs
| │ ├── Creative/ # Canva, PSD, video source
| │ └── PerformanceReports/ # monthly PDF exports from Meta, X, LinkedIn
| ├── Branding/
| │ ├── Logo/ # SVG, PNG, EPS
| │ ├── BrandGuidelines.pdf # the master doc
| │ ├── Colors_Typography/
| │ └── Templates/ # letterhead, business cards
| ├── Campaigns/ # one subfolder per campaign
| │ └── 2025-Q3-Launch/
| │ ├── Brief.md
| │ ├── Assets/
| │ ├── AdSets/ # raw Ad Manager exports
| │ └── Results/ # post-mortem deck, ROAS spreadsheet
| ├── Content/ # long-form top-of-funnel
| │ ├── BlogPosts/
| │ ├── Whitepapers/
| │ ├── Webinars/
| │ └── Scripts/
| ├── EmailMarketing/
| │ ├── DripSeries/
| │ ├── Newsletters/
| │ └── PerformanceReports/
| ├── Ads/ # paid media that is not part of a big campaign
| │ ├── GoogleAds/
| │ ├── LinkedInAds/
| │ └── MetaAds/
| ├── Events/ # conferences, webinars, community meetups
| │ └── 2025-SaaS-Expo/
| ├── CaseStudies/
| ├── Collateral/ # one-pagers, data sheets, pitch decks
| ├── PR/
| │ ├── PressReleases/
| │ ├── MediaMentions/
| │ └── AnalystRelations/
| └── Analytics_Reports/ # GA4, HubSpot, Amplitude exports
|
├── Clients/
| └── acme-co/ # lowercase, hyphenated, no spaces
│ | ├── Proposals/
| | ├── Agreements/
| | │ ├── msa_2024-01-15.pdf # master services agreement
| | │ ├── sow_2024-03-01_search-module.pdf # statement of work
| | │ └── nda_2023-12-20.pdf # non-disclosure agreement
| | ├── Invoices/
| | │ ├── ClientMemos/
| | │ │ └── 2025-06-18_cm_000349.pdf
| | │ ├── 2025/
| | │ │ └── 2025-06-15_inv_000345.pdf
| | │ └── 2024/
| | ├── Payments/ # remittance advice, wire confirmations
| | ├── Projects/
| | │ ├── search-module/ # one subfolder per project
| | │ │ ├── kickoff-notes.md
| | │ │ ├── deliverables/
| | │ │ ├── demos/
| | │ │ └── change-orders/
| | │ └── 2025-retainer/
| | └── Communication/ # email threads, call recordings, Slack exports
│ └── [ClientName2]/
│ ├── Proposals/
│ ├── Agreements/
│ ├── Invoices/
│ ├── Payments/
│ ├── Projects/
│ └── Communication/
|
├── Contractors/
│ ├── [ContractorName1]/
│ │ ├── contracts/
│ │ │ ├── sia_2024-02-10.pdf # services or independent contractor agreement
│ │ │ ├── nda_2024-02-01.pdf # non-disclosure agreement
│ │ │ └── ip_assignment.pdf # intellectual property assignment
│ │ ├── onboarding/
│ │ │ ├── w9_2024.pdf
│ │ │ ├── security-training-cert.pdf
│ │ │ └── preferred-name-acknowledgment.pdf
│ │ ├── offboarding/
│ │ │ └── return-of-property-cert.pdf
│ │ ├── statements-of-work/
│ │ │ └── sow_2024-03-15_dashboard-rewrite.pdf
| | ├── timesheets/
| | │ └── 2025/
| | │ └── 2025-06-14_timesheet.pdf
| | ├── invoices/
| | │ └── 2025/
| | │ └── 2025-06-15_invoice_1023.pdf
| | ├── payments/ # remittance proofs just like clients
| | └── deliverables/ # final code drops if not in Git
│ └── [ContractorName2]/
| └── ...
|
└── Sales/
├── Decks/ # customer-facing slides
├── Playbooks_Scripts/ # talk tracks, discovery questions
├── Templates/ # blank quote, proposal, SOW docs
├── ProspectLists/ # cold lists (lock down PII)
├── LeadManagement/ # MQL intake rules, scoring docs
├── Quotes_Proposals/
│ ├── 2025/
│ └── 2024/
├── Contracts_Orders/
│ ├── 2025/
│ └── 2024/
├── Pipeline_Forecasts/
│ ├── Weekly/ # 2025-06-13_pipeline.xlsx
│ └── QBRs/ # Q2-2025_forecast.pptx
├── Comp_Territory/
│ ├── CommissionPlans/
│ └── TerritoryMaps/
└── CRMExports/ # raw HubSpot/Salesforce dumps
Enforce SPF, DKIM, DMARC at p=quarantine or p=reject once you are comfortable with reports landing in dmarc@. If you keep devnull@, make sure it truly black-holes mail and is not listed as a reply-to address anywhere.
Email Aliases
| Email Group | Purpose / Use Case | Audience |
| ------------------------------ | --------------------------------------------------- | -------------------------- |
| abuse@ | Spam or abuse reports, required by RFC 2142 | External (mail admins) |
| admin@ | IT, system administration, internal tools | Internal |
| alerts@ | Monitoring and on-call alert sink | Internal |
| all@ | Announcements to entire company | Internal |
| billing@ | Invoices, payments, financial questions | Clients / Vendors |
| bugbounty@ / security-reports@ | Bug-bounty and security research submissions | External researchers |
| careers@ / jobs@ | Job applications and recruiting | Applicants |
| dmarc@ | Destination for DMARC aggregate reports | Automated report providers |
| devnull@ | Black hole for ignored or unmonitored replies | N/A |
| engineering@ | Developer team communication | Internal |
| escalations@ | Urgent issues that bypass normal support | Key clients / Execs |
| events@ | Sponsorship, conference, or webinar coordination | Public / Partners |
| feedback@ | Collect user or customer feedback | Public or Internal |
| finance@ | Internal financial planning and vendor coordination | Internal |
| helpdesk@ | Employee IT issues into ticketing system | Internal |
| hr@ | Internal HR matters, hiring coordination | Internal |
| incident@ | Thread for active incident response | Internal |
| info@ | General inquiries | Public / External |
| legal@ | Legal notices or compliance questions | Legal entities |
| management@ | Executive or leadership team communication | Internal |
| marketing@ | Campaigns, branding, outreach coordination | Internal |
| newsletter@ / updates@ | Marketing blasts or product release notes | Subscribers |
| no-reply@ | Outgoing-only automated notifications | External (one-way) |
| notices@ | System notifications, alerts | Internal |?
| notifications@ | General notifications, alerts | Internal |?
| onboarding@ / newhires@ | New-hire onboarding workflows | Internal |
| ops@ | DevOps, infrastructure, deployment coordination | Internal |
| partners@ | Business partnerships and B2B outreach | External / Partners |
| postmaster@ | Required by RFC 2142, MTA notifications | External (mail admins) |
| press@ | Media inquiries, PR contact | Journalists / Media |
| privacy@ | GDPR / CCPA privacy requests, breach notices | Regulators / Customers |
| purchasing@ / procurement@ | Orders, supplier quotes, PO approvals | Finance / Ops |
| sales@ | Sales questions, demos, lead generation | Prospects / Clients |
| security@ | Vulnerability reports, security alerts | External or Internal |
| support@ | Customer support | Clients / Customers |
| webmaster@ | Website problems, broken links, SSL errors | Public |
This entire knowledge base is powered by caffeine, hard-won experience, and a passionate commitment to minimizing distractions.
If you borrow ideas or content, please cite your source. 😇