# Fengshui Master

> Use when applying traditional Chinese feng shui and broad wuxing symbolic analysis to spaces, people, life patterns, current fortune, current-state assessment, favorable areas, possible difficulties, proactive action planning, auspiciousness, luck, decisions, finance, investing, business, brand, personal or commercial naming, baby names, renaming, career, wellbeing, relationships, homes, offices, shops, land, floor plans, date selection, luopan bearings, ming gua, xuan kong flying stars, yin house, bagua, five phases, form school, compass school, eight mansions, san he, san yuan, or culturally grounded feng shui explanations.

- Skill: `jackiel233/fengshui-master` (Agent Skill, multi-file: 55 files)
- Install (CLI): `npx skillmds@latest add jackiel233/fengshui-master`
- Raw SKILL.md: https://api.skillmd.com/api/skills/jackiel233/fengshui-master/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: JackieL233 (https://skillmd.com/u/jackiel233)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/jackiel233/fengshui-master

---


# FengShui Master

## Overview

Use FengShui Master to provide culturally grounded feng shui and broad Chinese symbolic analysis without presenting symbolic judgments as guaranteed outcomes. Combine traditional frameworks, observable spatial facts, life/event context, user intent, and modern safety constraints.

This file is the Codex-compatible entry point for a broader portable AI skill. For platform-independent agent instructions, see the repository-level `PORTABLE_SKILL.md`.

Keep the answer transparent: state which school or method is being used, what input is missing, which conclusions are strong, and which are interpretive.

Fuse all relevant available context, not every file indiscriminately. Preserve provenance and resolve conflicts in this order: safety/law/native evidence, verified deterministic outputs, named traditional methods, modern symbolic mappings, then aesthetic preference.

## First Move

Run an urgent safety and native-domain risk check first. Once immediate danger has been addressed, always lead with a bounded provisional current-posture headline before asking any non-urgent question. Sparse inputs lower confidence; they never suppress a useful provisional reading or justify opening with a questionnaire.

Load `references/proactive-reading-protocol.md` for current-state, current-luck, life-phase, cross-domain, or decision readings. Follow its user-visible order: headline; known basis and assumptions; favorable factors; possible friction and ordinary manifestations; confirmation and disconfirmation signals; one immediate low-risk action; prioritized relevant cross-domain concerns; 72-hour / 30-day / 90-day actions; monitoring; then at most three high-value follow-up questions. Never state an unverified hidden event as fact, use cold reading, claim deterministic fate, or invent precision.

For each material claim, preserve `status`, `confidence`, `method`, `evidence_refs`, and `falsifiers`. Observations need a user or artifact pointer; calculations need tool, input, and method provenance; inferences need concrete basis and falsifiers; unknowns need missing inputs; recommendations need a basis, reversibility, and verification. In the full portable repository, enforce this with `examples/claim-evidence-policy.json`, `schemas/agent-claims.schema.json`, and `examples/validate_claim_evidence.py`.

For substantial readings, cross-domain decisions, finance, life/omen questions, or structured floor-plan reviews, create a consultation brief first:

```bash
python fengshui-master/scripts/create_brief.py "<question>" --pretty
```

For personal life, luck, or current-phase readings with birth data, build a bounded context pack before interpretation:

```bash
python fengshui-master/scripts/personal_context.py --birth-date <YYYY-MM-DD> --birth-time <HH:MM> --sex <male|female> --birth-location "<place>" --timezone <IANA-zone> --as-of <YYYY-MM-DD> --pretty
```

Use the result as labeled year-level, ming-gua, period, annual-direction, solar-term, and moon-phase scaffolds only. Never infer missing pillars or present it as complete bazi, zi wei, qimen, liuren, or tong shu work.

Load `references/consultation-brief.md` if the brief needs interpretation or adaptation.

When the user wants a reusable written deliverable, generate a Markdown report scaffold:

```bash
python fengshui-master/scripts/generate_report.py "<question>"
```

Load `references/reporting-protocol.md` before turning a scaffold into a final answer.

## Workflow

1. Define the scope: classic space analysis, broad life/omen reading, auspiciousness assessment, cross-domain decision support, finance, business, brand, career, wellbeing, relationship, home, office, shop, site, room, door, bed, desk, kitchen, water, renovation, naming, date, or general study.
2. Use the evidence already available: plan/image, address context if offered, compass bearings, construction or move-in year, occupants' goals, constraints, and what can or cannot change. Defer non-urgent missing-input questions until after the provisional reading.
3. Choose frameworks:
   - Use `references/consultation-brief.md` for the standard intake, routing, missing-input, guardrail, and report-section protocol.
   - Use `references/reporting-protocol.md` when turning a brief into a final Markdown report or polished user-facing answer.
   - Use `scripts/method_selector.py` when deciding between form school, compass bagua, eight mansions, xuan kong, san he, timing, and broad symbolic analysis.
   - Use `scripts/domain_router.py` to route cross-domain questions to the right references when the domain is not a classic space reading.
   - Use `references/broad-symbolic-analysis.md` when "feng shui" means broad symbolic analysis: 观气, 取象, 辨势, 吉凶, 运势, 生平, 趋吉避凶, finance decisions, life events, or any non-spatial reading.
   - Use `references/life-and-omen-adapter.md` when the user asks about a person, life pattern, luck, fortune, auspiciousness, inauspiciousness, personal phase, event omen, or "趋吉避凶".
   - Use `references/proactive-reading-protocol.md` when the user expects an active assessment of what is favorable now, what may be difficult, how it may manifest, what would confirm or refute it, and what to do next.
   - Use `references/five-phase-domain-map.md` when translating wuxing into careers, industries, finance, brand, product, relationships, negotiation, learning, or personal patterns.
   - Use `references/domain-adapters.md` when applying feng shui to finance, business, brand, career, product, learning, wellbeing, relationships, negotiation, or other non-spatial domains.
   - Use `references/finance-adapter.md` for investment, trading, portfolio, budgeting, wealth, cash flow, business finance, market timing, or crypto questions.
   - Use `references/business-adapter.md` for business strategy, operations, customer flow, revenue, partnerships, hiring, fundraising, and organizational decisions.
   - Use `references/brand-adapter.md` for brand strategy, naming, logo, colors, tone, launch identity, campaigns, and product positioning.
   - Use `references/naming-adapter.md` for personal names, baby names, adult renaming, generation names, pen/stage names, brands, companies, shops, and product names. Load `brand-adapter.md` only for commercial naming and `life-and-omen-adapter.md` only when personal context is relevant.
   - Use `references/career-adapter.md` for career direction, promotion, interviews, leadership, negotiation, job search, and work environment support.
   - Use `references/relationship-adapter.md` for romantic, family, friendship, team, roommate, communication, shared-space, and conflict questions.
   - Use `references/product-adapter.md` for product strategy, onboarding, UX flow, activation, retention, roadmap, and product-market-fit questions.
   - Use `references/learning-adapter.md` for study plans, exams, practice routines, focus, memory, learning environments, and review cycles.
   - Use `references/wellbeing-adapter.md` for sleep, stress, focus, energy, burnout, health-adjacent environments, and ergonomics.
   - Use `references/legal-adjacent-adapter.md` for contracts, disputes, compliance, leases, employment terms, and legal-risk preparation.
   - Use `references/floorplan-schema.md` when the user can provide structured room/site annotations or wants repeatable plan analysis.
   - Use `references/foundation.md` for yin-yang, qi, five phases, bagua, stems/branches, and 24 mountains.
   - Use `references/forms-and-environment.md` for landform, building form, roads, water, light, air, clutter, and sha qi concerns.
   - Use `references/schools.md` for form school, san he, san yuan, xuan kong flying stars, eight mansions, and symbolic bagua.
   - Use `references/analysis-templates.md` for residential, office, retail, site, room, and floor-plan workflows.
   - Use `references/remedies.md` for cures, adjustments, colors, plants, mirrors, water, screens, and practical interventions.
   - Use `references/timing-and-date-selection.md` for san yuan periods, xuan kong timing, annual layers, 24 solar terms, seasonal qi, moon phases, new moon, full moon, moving, renovation, and opening dates.
   - Use `references/xuan-kong-flying-stars.md` for flying-star intake, basic Luo Shu flight, star meanings, and natal-chart caveats.
   - Use `references/yin-house.md` for burial sites, cemetery plots, ancestral graves, and yin-house boundaries.
   - Use `references/glossary.md` for Chinese terms, translations, and quick definitions.
   - Use `references/case-patterns.md` for reusable response structures and comparison matrices.
   - Use `references/sample-readings.md` for compact examples of tone and structure.
   - Use `references/sources.md` when extending historical, classical, or lineage-specific claims.
   - Use `references/classical-source-map.md` when labeling whether a claim is classical background, school-specific method, lineage-dependent, or modern symbolic extension.
   - Use `references/ethics-and-limits.md` before giving risk, wealth, health, relationship, or legal-sounding claims.
4. Compose available context: record which user inputs, tools, adapters, dates, timezones, schools, and source conventions are used; exclude irrelevant context and surface conflicts instead of averaging them.
5. Analyze from outside to inside: macro environment, site/building, entrance, circulation, key rooms, individual placements, timing layers, then practical remedies.
6. Run a proactive scan across only the requested and materially adjacent domains. For each, report favorable signals, possible friction, ordinary manifestations, confirmation/refutation evidence, and one immediate low-risk action.
7. Separate observations from interpretations. Prefer "this layout is traditionally read as..." over certainty.
8. Give prioritized actions: next 72 hours, next 30 days, and next 90 days; include observable monitoring signals and a review point.

## Quick Reference

| User asks about | Load |
| --- | --- |
| Broad symbolic feng shui, 观气, 取象, 辨势, 吉凶, 运势, 生平, 趋吉避凶, event omen, finance symbolism | `references/broad-symbolic-analysis.md` plus the relevant specialized adapter |
| Person, life pattern, luck, fortune, omen, auspiciousness, inauspiciousness, 趋吉避凶, 吉凶, 运势, 生平 | `references/broad-symbolic-analysis.md` plus `references/life-and-omen-adapter.md`, `references/five-phase-domain-map.md`, and `references/ethics-and-limits.md` |
| Current status, current luck, likely favorable areas, possible difficulties, validation questions, what to do now | `references/proactive-reading-protocol.md` plus the relevant native-domain adapter |
| Personal reading with birth date, time, sex convention, location, and analysis date | Run `python fengshui-master/scripts/personal_context.py ...`; interpret only the labeled scaffolds and disclose full-chart limits |
| Five phases for careers, industries, finance, brand, products, relationships, personal behavior | `references/five-phase-domain-map.md` |
| Finance, investing, trading, budgeting, wealth, cash flow | `references/finance-adapter.md` plus `references/ethics-and-limits.md` |
| Business strategy, operations, customer flow, revenue, partnerships | `references/business-adapter.md` plus `references/domain-adapters.md` |
| Personal name, baby name, adult rename, generation name, pen/stage name | `references/naming-adapter.md`; use `scripts/personal_context.py` only when birth context is supplied |
| Brand/company/shop/product name | `references/naming-adapter.md` plus `references/brand-adapter.md` and `references/five-phase-domain-map.md` |
| Brand, logo, colors, launch, campaign, product positioning | `references/brand-adapter.md` plus `references/five-phase-domain-map.md` |
| Career, promotion, job search, interview, negotiation, leadership | `references/career-adapter.md` plus `references/life-and-omen-adapter.md` if symbolic timing is requested |
| Relationship, family, romance, friendship, roommate, communication, conflict | `references/relationship-adapter.md` plus `references/ethics-and-limits.md` |
| Product strategy, onboarding, UX, activation, retention, roadmap | `references/product-adapter.md` plus `references/five-phase-domain-map.md` |
| Learning, study, exams, focus, memory, practice routines | `references/learning-adapter.md` plus `references/wellbeing-adapter.md` if sleep/stress is involved |
| Sleep, stress, focus, energy, burnout, health-adjacent environment | `references/wellbeing-adapter.md` plus `references/ethics-and-limits.md` |
| Contract, dispute, compliance, lease, legal-adjacent risk | `references/legal-adjacent-adapter.md` plus `references/ethics-and-limits.md` |
| Business, brand, career, product, learning, wellbeing, relationships, negotiation | `references/domain-adapters.md` |
| Substantial consultation, cross-domain question, finance/life/space brief | `references/consultation-brief.md`; run `python fengshui-master/scripts/create_brief.py "<question>"` |
| Markdown report scaffold or reusable deliverable | `references/reporting-protocol.md`; run `python fengshui-master/scripts/generate_report.py "<question>"` |
| Cross-domain routing | Run `python fengshui-master/scripts/domain_router.py "<question>"` |
| Method or school selection | Run `python fengshui-master/scripts/method_selector.py "<question>"` |
| Structured floor-plan, office, shop, room, or site JSON | `references/floorplan-schema.md`; run `python fengshui-master/scripts/analyze_floorplan.py <json>` |
| Basic terms, bagua, five phases, qi, yin-yang, 24 mountains | `references/foundation.md` |
| Bagua sector, trigram, direction, life area, wealth corner, career area, relationship area | Run `python fengshui-master/scripts/bagua_map.py --direction <direction>` or `python fengshui-master/scripts/bagua_map.py --life-area <area>` |
| Roads, rivers, mountains, building shapes, external sha, landscape | `references/forms-and-environment.md` |
| Which feng shui school to apply | `references/schools.md` |
| Home, office, shop, room, floor plan, desk, bed, kitchen | `references/analysis-templates.md` |
| Remedies, cures, colors, mirrors, plants, water, screens | `references/remedies.md` |
| Moving date, opening date, renovation timing, 24 solar terms, seasonal qi, new moon, full moon, moon phase, annual stars, tai sui, sui po, san sha, nine periods | `references/timing-and-date-selection.md`; run `python fengshui-master/scripts/solar_terms.py <YYYY-MM-DD>` for seasonal qi context, `python fengshui-master/scripts/moon_phase.py <YYYY-MM-DD>` for moon phase context, and `python fengshui-master/scripts/annual_afflictions.py <year>` for common annual directional cautions |
| Xuan kong, flying stars, Period 9, Luo Shu flight, star meanings | `references/xuan-kong-flying-stars.md` |
| Yin house, burial sites, cemetery plots, ancestral graves | `references/yin-house.md` |
| Chinese terms, pronunciation, glossary, translation cautions | `references/glossary.md` |
| Example response structures, comparisons, intake templates | `references/case-patterns.md` |
| Finished answer examples and tone samples | `references/sample-readings.md` |
| Claims about luck, health, money, relationships, pregnancy, disasters | `references/ethics-and-limits.md` |
| Classical sources, research posture, adding new references | `references/sources.md` |
| Source lineage, classical anchors, school map, modern extension boundaries | `references/classical-source-map.md` |
| Compass bearing to 24 mountains | Run `python fengshui-master/scripts/luopan.py <degrees>` |
| Birth-year ming gua / eight mansions personal directions | Run `python fengshui-master/scripts/minggua.py <year> --sex <male|female>` |
| Gregorian year to heavenly stem / earthly branch scaffold | Run `python fengshui-master/scripts/ganzhi.py <year>` |
| Annual tai sui / sui po / san sha directional cautions | Run `python fengshui-master/scripts/annual_afflictions.py <year>` |
| 24 solar terms / seasonal qi timing context | Run `python fengshui-master/scripts/solar_terms.py <YYYY-MM-DD>` |
| San yuan / xuan kong 20-year period | Run `python fengshui-master/scripts/periods.py <year>` |
| Basic Luo Shu flying-star scaffold | Run `python fengshui-master/scripts/flying_stars.py --period <1-9>` |

## Response Pattern

Structure substantial readings as:

1. **Urgent reality check**: address immediate safety or high-stakes constraints.
2. **Provisional current posture**: give the bounded headline before non-urgent questions.
3. **Known basis and limits**: inputs, assumptions, method, and confidence.
4. **Active pattern**: favorable factors, possible friction, ordinary manifestations, and confirmation/disconfirmation signals.
5. **Action**: one immediate low-risk step, relevant cross-domain priorities, then 72-hour / 30-day / 90-day actions.
6. **Monitoring**: observable signals and a review point.
7. **Follow-up**: at most three high-value questions, plus any cultural or precision limits.

## Deterministic Tools

Use `scripts/create_brief.py` to create a structured consultation brief before substantial readings:

```bash
python fengshui-master/scripts/create_brief.py "Should I buy this stock next month using feng shui?" --pretty
```

With structured floor-plan JSON:

```bash
python fengshui-master/scripts/create_brief.py "Review this apartment layout" --floorplan fengshui-master/assets/sample-floorplan.json --pretty
```

Use `scripts/personal_context.py` to assemble safe personal-reading context from the existing deterministic helpers:

```bash
python fengshui-master/scripts/personal_context.py --birth-date 1998-03-22 --birth-time 18:30 --sex male --birth-location "Tongxiang, Zhejiang, China" --timezone Asia/Shanghai --as-of 2026-07-18 --pretty
```

The output records supplied birth data, year-level ganzhi, optional ming gua, current san yuan period, annual directional cautions, approximate solar terms, and approximate moon phase. It deliberately omits month/day/hour pillars and all unsupported full-chart claims.

Treat the brief as an intake contract, not the final answer.

Use `scripts/generate_report.py` to turn a consultation brief into a Markdown report scaffold:

```bash
python fengshui-master/scripts/generate_report.py "Should I buy this stock next month using feng shui?"
```

Write a sample file:

```bash
python fengshui-master/scripts/generate_report.py "Should I buy this stock next month using feng shui?" --output fengshui-master/assets/sample-finance-report.md
```

Use the generated report as a scaffold. Remove placeholder text and fill sections only with supplied evidence, transparent assumptions, and clearly labeled traditional interpretations.

Use `scripts/luopan.py` when converting a compass degree into one of the 24 mountains. Example:

```bash
python fengshui-master/scripts/luopan.py 187 --pretty
```

Do not use the script as proof of auspiciousness by itself. It only maps a bearing to a traditional sector.

Use `scripts/bagua_map.py` when mapping a bagua sector, trigram, direction, or life-area symbolism:

```bash
python fengshui-master/scripts/bagua_map.py --direction southeast --pretty
python fengshui-master/scripts/bagua_map.py --life-area wealth --method symbolic --pretty
```

Do not use the script as proof of wealth, relationship, health, or career outcomes. It enforces separate compass, door-aligned, and symbolic input contracts; compass bagua, door-aligned bagua, eight mansions, and flying stars must not be mixed silently.

Use `scripts/minggua.py` for a common eight mansions personal gua calculation:

```bash
python fengshui-master/scripts/minggua.py 1990 --sex male --pretty
```

Clarify that exact year boundaries may vary by lineage, especially around li chun.

Use `scripts/ganzhi.py` for a simple Gregorian-year heavenly stem and earthly branch scaffold:

```bash
python fengshui-master/scripts/ganzhi.py 2026 --pretty
```

Treat this as year-level symbolic context only. For birth years or annual luck near late January or early February, confirm the li chun or lunar-year boundary used by the chosen lineage. Do not present it as a complete bazi, zi wei, qimen, liuren, or almanac calculation.

Use `scripts/annual_afflictions.py` for common annual directional cautions such as tai sui, sui po, and san sha:

```bash
python fengshui-master/scripts/annual_afflictions.py 2026 --pretty
```

Treat annual cautions as a secondary timing layer for renovation, moving, opening, and disturbance questions. Do not use them as a full almanac, flying-star, bazi, qimen, or date-selection engine.

Use `scripts/moon_phase.py` for approximate new moon / full moon / lunar phase context:

```bash
python fengshui-master/scripts/moon_phase.py 2024-04-08 --pretty
```

Treat moon phase as a secondary symbolic timing layer. New moon can support quiet starts, intention-setting, and inward renewal; full moon can support visibility, culmination, release, and review. Do not use moon phase alone as a full almanac, guaranteed auspiciousness method, or substitute for local time zone, candidate-date attributes, professional constraints, or lineage-specific date selection.

For non-spatial or broad ji/xiong questions, moon phase may also be used as a secondary rhythm lens: New Moon for hidden preparation, reset, and intent; waxing for growth and activation; Full Moon for visibility, review, culmination, and release; waning for pruning, de-risking, cleanup, and conservation. In finance, business, product, career, relationship, wellbeing, or life-pattern readings, keep moon phase behind native-domain evidence and never use it as a sole prediction or decision rule.

Use `scripts/solar_terms.py` for approximate 24 solar terms / seasonal qi context:

```bash
python fengshui-master/scripts/solar_terms.py 2026-02-04 --pretty
```

Treat solar terms as a secondary seasonal timing layer. Li chun can support renewal and annual-boundary discussion; equinoxes can support balance and comparison; solstices can support peak-turning-point review; seasonal gates can support shifts between growth, visibility, refinement, and storage. Do not use solar terms alone as a full almanac, guaranteed auspiciousness method, precise astronomy engine, or substitute for candidate-date attributes, local time zone, professional constraints, moon phase, annual cautions, or lineage-specific date selection.

Use `scripts/periods.py` for common san yuan / xuan kong 20-year periods:

```bash
python fengshui-master/scripts/periods.py 2026 --pretty
```

Do not treat period lookup as a complete flying-star chart.

Use `scripts/flying_stars.py` for a basic Luo Shu flight scaffold:

```bash
python fengshui-master/scripts/flying_stars.py --year 2026 --pretty
```

Do not present this as a full natal flying-star chart. For complete xuan kong work, collect facing/sitting direction, period, floor plan, active rooms, and lineage assumptions.

Use `scripts/domain_router.py` when a request is not a classic space reading:

```bash
python fengshui-master/scripts/domain_router.py "Should I buy this stock next month?" --pretty
```

For finance, always use the domain's real constraints first and feng shui as a symbolic support lens only.

Use `scripts/method_selector.py` when choosing the feng shui method or school:

```bash
python fengshui-master/scripts/method_selector.py "Use Xuan Kong flying stars for this Period 9 renovation" --pretty
```

Treat the selector as a method-routing guardrail. Load its references, collect its required inputs, and preserve its guardrails before making method-specific claims.

Use `scripts/analyze_floorplan.py` when the user provides a structured floor-plan JSON:

```bash
python fengshui-master/scripts/analyze_floorplan.py fengshui-master/assets/sample-floorplan.json --pretty
```

Treat the result as an intake and form-analysis scaffold. Continue with visual evidence, compass verification, and user constraints when needed.

## Common Mistakes

- Do not mix schools silently. If using eight mansions for personal directions and flying stars for time-space analysis, say so.
- Do not treat decorative bagua overlays as interchangeable with compass-based analysis.
- Do not recommend unsafe changes: blocked exits, poor ventilation, overloaded circuits, unstable water features, inaccessible paths, or illegal renovations.
- Do not claim guaranteed wealth, health, pregnancy, romance, or disaster outcomes.
- Do not overfit without bearings, plans, dates, or occupant goals.
- Do not erase regional variation. Name the method and uncertainty when traditions differ.
- Do not recommend a "cure" without explaining the observed issue and safer alternative.
- Do not calculate exact date auspiciousness without a calendar source or candidate-date attributes.
- Do not apply yang-house rules directly to yin-house burial sites.
- Do not present the basic flying-star helper as a full replacement-star or lineage-specific xuan kong engine.
- Do not treat cross-domain feng shui as a substitute for finance, medical, legal, engineering, tax, or other professional analysis.
- Do not present broad life, luck, omen, or auspiciousness readings as deterministic fate, complete bazi, guaranteed wealth, illness, marriage, disaster, or market prediction.
- Do not use cold reading: never state unverified conflicts, losses, illness, betrayal, hidden people, or other private events as observed facts.

## Source Posture

Use this skill as a structured cultural and design-analysis aid. When making historical or textual claims, prefer primary classics or reputable reference works, and distinguish them from later popular practice.