Skill Claude CodeCodex
Invoke ONLY when the user explicitly runs /ddg-apple-feedback-review or names this skill by name. Do NOT auto-invoke from symptom/intent matching. If the user asks about Apple feedback, iOS or macOS issues, user reports, or feedback triage without naming this skill, answer directly instead.
Skill Claude CodeCodex
Invoke ONLY when the user explicitly runs /ddg-diagnose-ci-failure or names this skill by name (e.g. "use ddg-diagnose-ci-failure on PR 4780"). Do NOT auto-invoke from symptom/intent matching - the skill may query the Apple CI Failing Tests Asana project (Step 3e), which locks other MCPs for the rest of the session…
Skill Claude CodeCodex
Invoke ONLY when the user explicitly runs /ddg-drk-add-icon or names this skill by name (e.g. "use ddg-drk-add-icon to add these SVGs"). Do NOT auto-invoke from symptom/intent matching — the skill mutates the apple-browsers asset catalog and Swift files and creates a git commit, so it must be user-initiated. If the…
Skill Claude CodeCodex
Invoke ONLY when the user explicitly runs /ddg-sentry-report or names this skill by name (e.g. "use ddg-sentry-report for macOS 1.186"). Do NOT auto-invoke from symptom/intent matching — the skill writes to a shared Asana task and must be user-initiated. If the user asks about Sentry issues or crash triage without…
Cursor rule Cursor
The DuckDuckGo browser includes a comprehensive A/B/N experiment framework that enables data-driven feature testing across iOS and macOS platforms. This framework allows you to safely experiment with new ideas while maintaining control groups and measuring impact.
Cursor rule Cursor
Use the existing Pixel.fire pattern with structured event definitions.
Cursor rule Cursor
Example: See singleton-antipattern.swift.
Cursor rule Cursor
The DuckDuckGo browser has moved away from traditional AppDelegate-based lifecycle handling to a state machine architecture. While AppDelegate still exists, it has been significantly thinned out and now delegates responsibility to a structured state machine.
Cursor rule Cursor
Cursor rule "architecture" from duckduckgo/apple-browsers, covering duckduckgo browser architecture guidelines, overall architecture, architecture patterns, mvvm for swiftui views and coordinator pattern.
Cursor rule Cursor
DuckDuckGo browser development follows GitHub Flow, a streamlined branching strategy that maintains a single main branch with feature branches for development work.
Cursor rule Cursor
BrowserServicesKit is the core shared library providing essential browser functionality to both iOS and macOS DuckDuckGo applications. It ensures consistent behavior and code reuse across platforms while maintaining privacy as the primary focus.
Cursor rule Cursor
This style guide is based on the official iOS style guide and incorporates DuckDuckGo-specific patterns and requirements.
Cursor rule Cursor
The DuckDuckGo iOS design system is implemented through DesignResourcesKit (DRK), a shared Swift package that contains our design tokens, type styles, colors, and design system elements.
Cursor rule Cursor
Use these instructions when you need to.
Cursor rule Cursor
Guidelines for app-level documentation under macOS/DuckDuckGo/Documentation.docc/.
Cursor rule Cursor
How to organize DocC documentation between package and app level; the entry point for any task that creates or updates DocC articles.
Cursor rule Cursor
Core principles for organizing documentation by abstraction level and maintaining quality.
Cursor rule Cursor
DuckPlayer uses two primary UserScript components to bridge native iOS functionality with web content.
Cursor rule Cursor
DuckPlayer provides video playback within the app, separate from the web view-based player. The architecture separates concerns into distinct components using a presenter pattern, native UI views, and JavaScript integration for seamless video playback experiences.
Cursor rule Cursor
Interactive pattern for adding feature flags to iOS and/or macOS with proper configuration.
Cursor rule Cursor
Use enum-based feature flags with protocols for type safety.
Cursor rule Cursor
This is the DuckDuckGo browser for iOS and macOS, built with privacy-first principles, modern Swift patterns, and cross-platform architecture.
Cursor rule Cursor
Prevent accidental or unrequested import churn that causes build/lint issues and diffs unrelated to the task. Ensure SwiftUI is only imported where required (e.g., #Preview blocks) and avoid touching existing imports unless strictly necessary.
Cursor rule Cursor
Pattern for abstracting pixel and wide event instrumentation behind domain-specific protocols.