@thiagodiogo/pscode 1.0.0 → 1.0.1

package/dist/core/templates/workflows/archive-change.js

@@ -1,26 +1,26 @@
-export function getArchiveChangeSkillTemplate() {
+export function getCompleteChangeSkillTemplate() {
     return {
         name: 'pscode-archive-change',
-        description: 'Archive a completed change. Use when the user wants to finalize and archive a change after implementation is complete.',
+        description: 'Complete a completed change. Use when the user wants to finalize and complete a change after implementation is complete.',
         instructions: getArchiveInstructions(),
         license: 'MIT',
         compatibility: 'Requires pscode CLI.',
         metadata: { author: 'pscode', version: '1.0' },
     };
 }
-export function getPsArchiveCommandTemplate() {
+export function getPsCompleteCommandTemplate() {
     return {
-        name: 'PS: Archive',
-        description: 'Archive a completed change',
+        name: 'PS: Complete',
+        description: 'Complete a change',
         category: 'Workflow',
-        tags: ['workflow', 'archive'],
+        tags: ['workflow', 'complete'],
         content: getArchiveInstructions(),
     };
 }
 function getArchiveInstructions() {
-    return `Archive a completed change.
+    return `Complete a change.
 
-**Input**: Optionally specify a change name (e.g., \`/ps:archive add-auth\`). If omitted, check if it can be inferred from conversation context. If vague or ambiguous you MUST prompt for available changes.
+**Input**: Optionally specify a change name (e.g., \`/ps:complete add-auth\`). If omitted, check if it can be inferred from conversation context. If vague or ambiguous you MUST prompt for available changes.
 
 **Steps**
 
@@ -116,7 +116,7 @@ function getArchiveInstructions() {
      mcp__claude_ai_Trello_Custom__create_card
        list_id: "<lists.done.id>"
        name: "<human-readable change name in Portuguese>"
-       desc: "Arquivada via /ps:archive"
+       desc: "Concluida via /ps:complete"
      \`\`\`
      Then mark it complete.
 
@@ -140,7 +140,7 @@ function getArchiveInstructions() {
    mcp__claude_ai_Trello_Custom__add_comment
      card_id: "<cardId>"
      text: |
-       Change arquivada via /ps:archive
+       Change concluida via /ps:complete
 
        Change: <change-name>
        Schema: <schema-name>

package/dist/core/templates/workflows/onboard.js

@@ -412,25 +412,25 @@ All tasks done:
 - [x] Task 2
 - [x] ...
 
-The change is implemented! One more step—let's archive it.
+The change is implemented! One more step—let's complete it.
 \`\`\`
 
 ---
 
-## Phase 10: Archive
+## Phase 10: Complete
 
 **EXPLAIN:**
 \`\`\`
-## Archiving
+## Completing
 
-When a change is complete, we archive it. The archive path is derived from \`planningHome.changesDir\` and the date.
+When a change is complete, we complete it. The archive path is derived from \`planningHome.changesDir\` and the date.
 
-Archived changes become your project's decision history—you can always find them later to understand why something was built a certain way.
+Completed changes become your project's decision history—you can always find them later to understand why something was built a certain way.
 \`\`\`
 
 **DO:**
 \`\`\`bash
-pscode archive "<name>"
+pscode complete "<name>"
 \`\`\`
 
 **SHOW:**
@@ -463,7 +463,7 @@ automaticamente cards no Trello conforme você avança nas suas changes.
 - /ps:draft  → registra ideias em "Para Explorar"
 - /ps:propose → move card para "Em Refinamento"
 - /ps:apply  → move card para "Em Desenvolvimento" e depois "Em Teste"
-- /ps:archive → move card para "Concluído"
+- /ps:complete → move card para "Concluído"
 
 Deseja configurar agora?
 \`\`\`
@@ -507,7 +507,7 @@ This same rhythm works for any size change—a small fix or a major feature.
  | \`/ps:propose\`     | Create a change and generate all artifacts |
  | \`/ps:explore\`     | Think through problems before/during work  |
  | \`/ps:apply\`       | Implement tasks from a change              |
- | \`/ps:archive\`     | Archive a completed change                 |
+ | \`/ps:complete\`     | Complete a change                          |
 
 **Additional commands:**
 
@@ -567,7 +567,7 @@ If the user says they just want to see the commands or skip the tutorial:
  | \`/ps:propose <name>\` | Create a change and generate all artifacts |
  | \`/ps:explore\`        | Think through problems (no code changes)   |
  | \`/ps:apply <name>\`   | Implement tasks                            |
- | \`/ps:archive <name>\` | Archive when done                          |
+ | \`/ps:complete <name>\` | Complete when done                         |
 
 **Additional commands:**
 

package/dist/core/update.d.ts

@@ -35,14 +35,9 @@ export declare class UpdateCommand {
      */
     private detectNewTools;
     /**
-     * Displays a note about extra workflows installed that aren't in the current profile.
+     * Displays a note about extra workflows installed that aren't in the active profile.
      */
     private displayExtraWorkflowsNote;
-    /**
-     * Suggest opting back into core when a custom profile still matches the old
-     * pre-sync core set. Keep custom profiles user-owned; do not mutate them.
-     */
-    private displayOldCoreCustomProfileNote;
     /**
      * Removes skill directories for workflows when delivery changed to commands-only.
      * Returns the number of directories removed.

package/dist/core/update.js

@@ -17,13 +17,12 @@ import { getToolVersionStatus, getSkillTemplates, getCommandContents, generateSk
 import { detectLegacyArtifacts, cleanupLegacyArtifacts, formatCleanupSummary, formatDetectionSummary, getToolsFromLegacyArtifacts, } from './legacy-cleanup.js';
 import { isInteractive } from '../utils/interactive.js';
 import { getGlobalConfig } from './global-config.js';
-import { getProfileWorkflows, ALL_WORKFLOWS } from './profiles.js';
+import { getProfileWorkflows, isValidProfile, DEFAULT_PROFILE, ALL_WORKFLOWS } from './profiles.js';
 import { getAvailableTools } from './available-tools.js';
 import { WORKFLOW_TO_SKILL_DIR, getCommandConfiguredTools, getConfiguredToolsForProfileSync, getToolsNeedingProfileSync, } from './profile-sync-drift.js';
 import { scanInstalledWorkflows as scanInstalledWorkflowsShared, migrateIfNeeded as migrateIfNeededShared, } from './migration.js';
 const require = createRequire(import.meta.url);
 const { version: PSCODE_VERSION } = require('../../package.json');
-const OLD_CORE_WORKFLOWS = ['propose', 'explore', 'apply', 'archive'];
 /**
  * Scans installed workflow artifacts (skills and managed commands) across all configured tools.
  * Returns the union of detected workflow IDs that match ALL_WORKFLOWS.
@@ -54,13 +53,9 @@ export class UpdateCommand {
         migrateIfNeededShared(resolvedProjectPath, detectedTools);
         // 3. Read global config for profile/delivery
         const globalConfig = getGlobalConfig();
-        const profile = globalConfig.profile ?? 'core';
+        const profile = isValidProfile(globalConfig.profile ?? '') ? globalConfig.profile : DEFAULT_PROFILE;
         const delivery = globalConfig.delivery ?? 'both';
-        const profileWorkflows = getProfileWorkflows(profile, globalConfig.workflows);
-        // Trello workflows are always included regardless of profile, mirroring InitCommand behavior.
-        const TRELLO_WORKFLOWS = ['trello-setup', 'task', 'draft'];
-        const workflowsSet = new Set([...profileWorkflows, ...TRELLO_WORKFLOWS]);
-        const desiredWorkflows = [...workflowsSet].filter((workflow) => ALL_WORKFLOWS.includes(workflow));
+        const desiredWorkflows = [...getProfileWorkflows(profile)];
         const shouldGenerateSkills = delivery !== 'commands';
         const shouldGenerateCommands = delivery !== 'skills';
         // 4. Detect and handle legacy artifacts + upgrade legacy tools using effective config
@@ -99,7 +94,6 @@ export class UpdateCommand {
             // Still check for new tool directories and extra workflows
             this.detectNewTools(resolvedProjectPath, configuredTools);
             this.displayExtraWorkflowsNote(resolvedProjectPath, configuredTools, desiredWorkflows);
-            this.displayOldCoreCustomProfileNote(profile, globalConfig.workflows);
             return;
         }
         // 8. Display update plan
@@ -206,7 +200,6 @@ export class UpdateCommand {
         this.detectNewTools(resolvedProjectPath, configuredAndNewTools);
         // 14. Display note about extra workflows not in profile
         this.displayExtraWorkflowsNote(resolvedProjectPath, configuredAndNewTools, desiredWorkflows);
-        this.displayOldCoreCustomProfileNote(profile, globalConfig.workflows);
         // 15. List affected tools
         if (updatedTools.length > 0) {
             const toolDisplayNames = updatedTools;
@@ -260,33 +253,16 @@ export class UpdateCommand {
         }
     }
     /**
-     * Displays a note about extra workflows installed that aren't in the current profile.
+     * Displays a note about extra workflows installed that aren't in the active profile.
      */
     displayExtraWorkflowsNote(projectPath, configuredTools, profileWorkflows) {
         const installedWorkflows = scanInstalledWorkflows(projectPath, configuredTools);
         const profileSet = new Set(profileWorkflows);
         const extraWorkflows = installedWorkflows.filter((w) => !profileSet.has(w));
         if (extraWorkflows.length > 0) {
-            console.log(chalk.dim(`Note: ${extraWorkflows.length} extra workflows not in profile (use \`pscode config profile\` to manage)`));
+            console.log(chalk.dim(`Note: ${extraWorkflows.length} extra workflows not in profile (use \`pscode config profile\` to switch profiles)`));
         }
     }
-    /**
-     * Suggest opting back into core when a custom profile still matches the old
-     * pre-sync core set. Keep custom profiles user-owned; do not mutate them.
-     */
-    displayOldCoreCustomProfileNote(profile, workflows) {
-        if (profile !== 'custom' || !workflows) {
-            return;
-        }
-        const workflowSet = new Set(workflows);
-        const matchesOldCore = workflowSet.size === OLD_CORE_WORKFLOWS.length &&
-            OLD_CORE_WORKFLOWS.every((workflow) => workflowSet.has(workflow));
-        if (!matchesOldCore) {
-            return;
-        }
-        console.log(chalk.dim('Note: The core profile now includes sync. Your custom profile is preserving the old core workflow set.'));
-        console.log(chalk.dim('Run `pscode config profile core` and then `pscode update` to add sync.'));
-    }
     /**
      * Removes skill directories for workflows when delivery changed to commands-only.
      * Returns the number of directories removed.

package/dist/core/workspace/foundation.d.ts

@@ -34,7 +34,7 @@ export interface WorkspaceViewState {
 }
 export interface WorkspaceSkillState {
     selected_agents: string[];
-    last_applied_profile?: 'core' | 'custom';
+    last_applied_profile?: string;
     last_applied_delivery?: 'both' | 'skills' | 'commands';
     last_applied_workflow_ids?: string[];
     last_applied_at?: string;

package/dist/core/workspace/foundation.js

@@ -116,7 +116,7 @@ const WorkspaceContextSchema = WorkspaceInitiativeContextSchema;
 const WorkspaceSkillStateSchema = z
     .object({
     selected_agents: z.array(z.string()),
-    last_applied_profile: z.enum(['core', 'custom']).optional(),
+    last_applied_profile: z.string().optional(),
     last_applied_delivery: z.enum(['both', 'skills', 'commands']).optional(),
     last_applied_workflow_ids: z.array(z.string()).optional(),
     last_applied_at: z.string().optional(),

package/dist/core/workspace/legacy-state.js

@@ -29,7 +29,7 @@ const PreferredOpenerSchema = z
 const WorkspaceSkillStateSchema = z
     .object({
     selected_agents: z.array(z.string()),
-    last_applied_profile: z.enum(['core', 'custom']).optional(),
+    last_applied_profile: z.enum(['standard', 'dixi']).optional(),
     last_applied_delivery: z.enum(['both', 'skills', 'commands']).optional(),
     last_applied_workflow_ids: z.array(z.string()).optional(),
     last_applied_at: z.string().optional(),

package/dist/core/workspace/skills.d.ts

@@ -1,5 +1,6 @@
 import { type AIToolOption } from '../config.js';
-import { type Delivery, type Profile } from '../global-config.js';
+import { type Delivery } from '../global-config.js';
+import { type ProfileName } from '../profiles.js';
 import type { WorkspaceSkillState } from './foundation.js';
 export interface WorkspaceSkillAgentResult {
     tool_id: string;
@@ -22,7 +23,7 @@ export interface WorkspaceSkillFailedResult {
     error: string;
 }
 export interface WorkspaceSkillInstallationReport {
-    profile: Profile;
+    profile: ProfileName;
     delivery: Delivery;
     workflow_ids: string[];
     selected_agents: string[];
@@ -39,7 +40,7 @@ type WorkspaceSkillCapableTool = AIToolOption & {
     skillsDir: string;
 };
 export declare function getCurrentWorkspaceSkillProfileSelection(): {
-    profile: Profile;
+    profile: ProfileName;
     delivery: Delivery;
     workflow_ids: string[];
 };

package/dist/core/workspace/skills.js

@@ -4,16 +4,16 @@ import { FileSystemUtils } from '../../utils/file-system.js';
 import { transformToHyphenCommands } from '../../utils/command-references.js';
 import { AI_TOOLS } from '../config.js';
 import { getGlobalConfig } from '../global-config.js';
-import { getProfileWorkflows } from '../profiles.js';
+import { getProfileWorkflows, isValidProfile, DEFAULT_PROFILE } from '../profiles.js';
 import { generateSkillContent, getSkillTemplates, getToolSkillStatus, getToolsWithSkillsDir, extractGeneratedByVersion, } from '../shared/index.js';
 const require = createRequire(import.meta.url);
 const { version: PSCODE_VERSION } = require('../../../package.json');
 const fs = nodeFs.promises;
 function resolveWorkspaceSkillProfileContext() {
     const globalConfig = getGlobalConfig();
-    const profile = globalConfig.profile ?? 'core';
+    const profile = isValidProfile(globalConfig.profile ?? '') ? globalConfig.profile : DEFAULT_PROFILE;
     const delivery = globalConfig.delivery ?? 'both';
-    const workflowIds = [...getProfileWorkflows(profile, globalConfig.workflows)];
+    const workflowIds = [...getProfileWorkflows(profile)];
     const deliveryNotice = delivery === 'skills'
         ? null
         : 'Workspace setup installs skills only; workspace command generation is not part of this slice.';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thiagodiogo/pscode",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "AI-native system for spec-driven development",
   "keywords": [
     "pscode",
@@ -12,7 +12,7 @@
   "homepage": "https://github.com/eipastel/pscode",
   "repository": {
     "type": "git",
-    "url": "https://github.com/eipastel/pscode"
+    "url": "git+https://github.com/eipastel/pscode.git"
   },
   "license": "MIT",
   "author": "thiagodiogo",
@@ -27,12 +27,13 @@
     }
   },
   "bin": {
-    "pscode": "./bin/pscode.js"
+    "pscode": "bin/pscode.js"
   },
   "files": [
     "dist",
     "bin",
     "schemas",
+    "pscode/content",
     "scripts/postinstall.js",
     "!dist/**/*.test.js",
     "!dist/**/__tests__",

package/pscode/content/dixi/architectures/feature-sliced-react/eslint-architecture.mjs.template

@@ -0,0 +1,44 @@
+// eslint-architecture.mjs
+// Regras de isolamento arquitetural para feature-sliced design.
+//
+// Integração: adicione ao seu eslint.config.js:
+//
+//   import architectureRules from './eslint-architecture.mjs';
+//   export default [...existingConfig, ...architectureRules];
+
+export default [
+  {
+    files: ['src/features/**/*.{ts,tsx,js,jsx}'],
+    rules: {
+      'no-restricted-imports': [
+        'error',
+        {
+          patterns: [
+            {
+              group: ['../features/*', '../../features/*', '@/features/*/'],
+              message:
+                'Features não devem importar umas das outras. Use shared/ para código compartilhado.',
+            },
+          ],
+        },
+      ],
+    },
+  },
+  {
+    files: ['src/pages/**/*.{ts,tsx}', 'src/app/**/*.{ts,tsx}'],
+    rules: {
+      'no-restricted-imports': [
+        'error',
+        {
+          patterns: [
+            {
+              group: ['*/application/*', '*/domain/*', '*/usecases/*'],
+              message:
+                'Páginas não devem importar lógica de negócio diretamente. Use features/ ou shared/ como intermediários.',
+            },
+          ],
+        },
+      ],
+    },
+  },
+];

package/pscode/content/dixi/architectures/feature-sliced-react/features/README.md.template

@@ -0,0 +1,30 @@
+# Features
+
+Cada feature é uma unidade autônoma de funcionalidade de negócio.
+
+## Estrutura de uma feature
+
+```
+features/
+└── nome-da-feature/
+    ├── components/    # Componentes React específicos da feature
+    ├── hooks/         # React hooks específicos da feature
+    ├── services/      # Chamadas de API específicas da feature
+    ├── types/         # Tipos TypeScript específicos da feature
+    └── index.ts       # Ponto de entrada — exporta apenas a API pública
+```
+
+## Regras de importação
+
+- Features **não importam umas das outras**
+  - ❌ `import { foo } from '@/features/outra-feature'`
+  - ✅ Mova o código compartilhado para `shared/`
+- Código compartilhado vive em `shared/` (componentes, hooks, serviços, tipos, utils)
+- Páginas (`pages/` ou `app/`) podem importar de `features/` via `index.ts`
+
+## Como criar uma nova feature
+
+1. Crie o diretório `features/nome-da-feature/`
+2. Adicione subdiretórios conforme necessário (`components/`, `hooks/`, etc.)
+3. Exporte a API pública via `index.ts`
+4. Importe nas páginas via `@/features/nome-da-feature`

package/pscode/content/dixi/architectures/feature-sliced-react/skeleton.yaml

@@ -0,0 +1,8 @@
+dirs:
+  - src/shared/components/ui
+  - src/shared/hooks
+  - src/shared/services
+  - src/shared/types
+  - src/shared/utils
+  - src/entities
+  - src/features

package/pscode/content/dixi/architectures/hexagonal-spring/ArchitectureTest.java.template

@@ -0,0 +1,41 @@
+package {basePackage};
+
+import com.tngtech.archunit.core.domain.JavaClasses;
+import com.tngtech.archunit.core.importer.ClassFileImporter;
+import com.tngtech.archunit.lang.ArchRule;
+import org.junit.jupiter.api.Test;
+
+import static com.tngtech.archunit.lang.syntax.ArchRuleDefinition.noClasses;
+
+public class ArchitectureTest {
+
+    private static final JavaClasses classes =
+        new ClassFileImporter().importPackages("{basePackage}");
+
+    @Test
+    void dominio_nao_deve_depender_de_infra() {
+        ArchRule rule = noClasses()
+            .that().resideInAPackage("{basePackage}.domain..")
+            .should().dependOnClassesThat()
+            .resideInAPackage("{basePackage}.infrastructure..");
+        rule.check(classes);
+    }
+
+    @Test
+    void aplicacao_nao_deve_depender_de_infra() {
+        ArchRule rule = noClasses()
+            .that().resideInAPackage("{basePackage}.application..")
+            .should().dependOnClassesThat()
+            .resideInAPackage("{basePackage}.infrastructure..");
+        rule.check(classes);
+    }
+
+    @Test
+    void adapter_in_nao_deve_depender_de_adapter_out() {
+        ArchRule rule = noClasses()
+            .that().resideInAPackage("{basePackage}.infrastructure.adapter.in..")
+            .should().dependOnClassesThat()
+            .resideInAPackage("{basePackage}.infrastructure.adapter.out..");
+        rule.check(classes);
+    }
+}

package/pscode/content/dixi/architectures/hexagonal-spring/skeleton.yaml

@@ -0,0 +1,11 @@
+dirs:
+  - src/main/java/{basePackageDir}/domain/model
+  - src/main/java/{basePackageDir}/domain/port/in
+  - src/main/java/{basePackageDir}/domain/port/out
+  - src/main/java/{basePackageDir}/application/usecase
+  - src/main/java/{basePackageDir}/infrastructure/adapter/in/rest
+  - src/main/java/{basePackageDir}/infrastructure/adapter/out/persistence
+  - src/main/java/{basePackageDir}/infrastructure/config
+  - src/test/java/{basePackageDir}/domain
+  - src/test/java/{basePackageDir}/application
+  - src/test/java/{basePackageDir}/infrastructure

package/pscode/content/dixi/claude-runtime/CLAUDE.md.java.template

@@ -0,0 +1,62 @@
+<!-- dixi-constitutional -->
+# Regras Constitucionais — Java/Spring (Arquitetura Hexagonal)
+
+> Regras invioláveis. Não negocie sem motivo documentado.
+> Detalhes completos em `pastelsdd/context/`.
+
+## Arquitetura Hexagonal
+
+### Camadas (da mais interna para a mais externa)
+- `domain/` — entidades, value objects, interfaces de repositório, regras de negócio puras
+- `application/` — use cases, ports (interfaces de entrada e saída)
+- `infrastructure/` — adapters (JPA, REST controllers, messaging, config)
+
+### Regra de Dependência (OBRIGATÓRIO)
+```
+infrastructure → application → domain
+```
+- `domain` não importa NADA de `application` ou `infrastructure`
+- `application` não importa NADA de `infrastructure`
+- Adapters (`infrastructure`) só acessam `application` via interfaces (ports)
+
+### Imports Proibidos
+- `domain.*` nunca importa `application.*` ou `infrastructure.*`
+- `application.*` nunca importa `infrastructure.*`
+- Exceção: testes de integração em `infrastructure/` podem referenciar qualquer camada
+
+## Nomenclatura por Camada
+
+| Camada | Sufixo/Convenção |
+|--------|------------------|
+| `domain/entity/` | `Order`, `Customer` (sem sufixo) |
+| `domain/repository/` | `OrderRepository` (interface) |
+| `domain/service/` | `PricingService` (interface/pura) |
+| `application/usecase/` | `CreateOrderUseCase` |
+| `application/port/in/` | `CreateOrderPort` |
+| `application/port/out/` | `SaveOrderPort` |
+| `infrastructure/adapter/in/` | `OrderController`, `OrderListener` |
+| `infrastructure/adapter/out/` | `OrderJpaAdapter`, `OrderEmailAdapter` |
+
+## Commits
+
+Formato obrigatório: `<type>(<scope>): <msg> [TICKET-123]`
+
+- `type`: `feat`, `fix`, `refactor`, `test`, `docs`, `chore`
+- `scope`: módulo ou camada afetada (e.g., `order`, `domain`, `infra`)
+- Ticket JIRA obrigatório. Se não houver ticket, usar `[NO-TICKET]`
+
+Exemplos:
+```
+feat(order): add CreateOrderUseCase [PROJ-42]
+fix(infra): correct JPA mapping for OrderStatus [PROJ-55]
+```
+
+## Referências
+
+Docs completos em `pastelsdd/context/`:
+- `pastelsdd/context/java/architecture.md` — guia completo de arquitetura hexagonal
+- `pastelsdd/context/java/naming.md` — convenções de nomenclatura por camada
+- `pastelsdd/context/shared/commits.md` — convenção completa de commits
+- `pastelsdd/context/shared/dev-flow.md` — fluxo de desenvolvimento e PR
+
+> Se `pastelsdd/context/` não existe, rode `pscode init --profile dixi` para instalar.

package/pscode/content/dixi/claude-runtime/CLAUDE.md.react.template

@@ -0,0 +1,74 @@
+<!-- dixi-constitutional -->
+# Regras Constitucionais — React/Next.js + TypeScript (Feature-Sliced Design)
+
+> Regras invioláveis. Não negocie sem motivo documentado.
+> Detalhes completos em `pastelsdd/context/`.
+
+## Feature-Sliced Design
+
+### Camadas (da mais compartilhada para a mais específica)
+```
+shared → entities → features → pages/app
+```
+- `shared/` — UI primitivos, utilitários, tipos globais, configuração de API
+- `entities/` — modelos de domínio (User, Order) sem lógica de feature
+- `features/` — funcionalidades de produto isoladas (auth, cart, checkout)
+- `pages/` ou `app/` — composição de features e rotas (Next.js)
+
+### Regra de Isolamento de Features (OBRIGATÓRIO)
+- **Features NÃO importam umas das outras**
+- Se dois features precisam de algo em comum → mover para `entities/` ou `shared/`
+- `pages/app` orquestra features; não contém lógica de negócio
+
+### Imports Proibidos
+- `features/auth` nunca importa `features/cart` (ou qualquer outro feature)
+- `shared/` nunca importa `entities/` ou `features/`
+- `entities/` nunca importa `features/`
+
+## Nomenclatura
+
+| Tipo | Convenção |
+|------|-----------|
+| Componentes React | `PascalCase` — `UserCard`, `OrderList` |
+| Hooks | `use` + `PascalCase` — `useUserSession`, `useCartItems` |
+| Services / API | `camelCase` — `userService`, `orderApi` |
+| Arquivos de componente | `PascalCase.tsx` — `UserCard.tsx` |
+| Arquivos de hook | `camelCase.ts` — `useUserSession.ts` |
+| Arquivos de tipo | `camelCase.types.ts` ou `types.ts` no módulo |
+| Testes | `<nome>.test.tsx` no mesmo diretório |
+
+## Estrutura Interna de um Feature
+
+```
+features/auth/
+  ui/          ← componentes do feature
+  model/       ← store, hooks, lógica de estado
+  api/         ← chamadas de API específicas do feature
+  lib/         ← helpers internos
+  index.ts     ← API pública do feature (barrel export)
+```
+Só o que está em `index.ts` pode ser importado de fora do feature.
+
+## Commits
+
+Formato obrigatório: `<type>(<scope>): <msg> [TICKET-123]`
+
+- `type`: `feat`, `fix`, `refactor`, `test`, `docs`, `chore`
+- `scope`: feature ou camada afetada (e.g., `auth`, `cart`, `shared`)
+- Ticket JIRA obrigatório. Se não houver ticket, usar `[NO-TICKET]`
+
+Exemplos:
+```
+feat(auth): add OAuth2 login flow [PROJ-10]
+fix(cart): correct item count on empty cart [PROJ-23]
+```
+
+## Referências
+
+Docs completos em `pastelsdd/context/`:
+- `pastelsdd/context/react/architecture.md` — guia completo de feature-sliced design
+- `pastelsdd/context/react/naming.md` — convenções de nomenclatura
+- `pastelsdd/context/shared/commits.md` — convenção completa de commits
+- `pastelsdd/context/shared/dev-flow.md` — fluxo de desenvolvimento e PR
+
+> Se `pastelsdd/context/` não existe, rode `pscode init --profile dixi` para instalar.